Method Match

string.go:874–909

Match matches the string with given regexp and returns a new Match instance with found submatches. If regexp is invalid or string doesn't match regexp, Match fails and returns empty (but non-nil) instance. regexp.Compile is used to construct regexp, and Regexp.FindStringSubmatch is used to construc

(re string)

//	m.NamedSubmatch("host").IsEqual("example.com")
//	m.NamedSubmatch("user").IsEqual("john")
func (s *String) Match(re string) *Match {
	opChain := s.chain.enter("Match()")
	defer opChain.leave()

	if opChain.failed() {
		return newMatch(opChain, nil, nil)
	}

	rx, err := regexp.Compile(re)
	if err != nil {
		opChain.fail(AssertionFailure{
			Type:   AssertValid,
			Actual: &AssertionValue{re},
			Errors: []error{
				errors.New("expected: valid regexp"),
				err,
			},
		})
		return newMatch(opChain, nil, nil)
	}

	match := rx.FindStringSubmatch(s.value)
	if match == nil {
		opChain.fail(AssertionFailure{
			Type:     AssertMatchRegexp,
			Actual:   &AssertionValue{s.value},
			Expected: &AssertionValue{re},
			Errors: []error{
				errors.New("expected: string matches regexp"),
			},
		})
		return newMatch(opChain, nil, nil)
	}

	return newMatch(opChain, match, rx.SubexpNames())
}

// NotMatch succeeds if the string doesn't match to given regexp.
//