Feature - Add ability to provide RegEx expressions

[krptodr]

It would be nice to pass regular expression to the Guard.Against method where the expression is processed. Thinking further on the idea, I'm not sure how I would name these methods to help with readability.

[ardalis]

Guard.Against.StringsMatching(RegEx expression) ?

[MojtabaKiani]

I think it must be some thing like this :

    public static string BadFormat([JetBrainsNotNull] this IGuardClause guardClause, [JetBrainsNotNull] string input, [JetBrainsNotNull] string parameterName, [JetBrainsNotNull] string regexPattern)
    {
        if (input != Regex.Match(input, regexPattern).Value)
            throw new ArgumentException($"Input {parameterName} was not in required format", parameterName);

        return input;
    }

[ardalis]

Want to PR that? Do we like Bad or Invalid format better?

[MojtabaKiani]

yep, InvalidFormat is better, I've sent the PR

[krptodr]

Here is the method I implemented. I went with one of @ardalis's early implementation of the a guard clause

public static void ForRegExMatch(string pattern, string value, string parameterName, string message = null)
        {
            if (value == null)
                return;

            if (new Regex(@pattern).IsMatch(value))
                return;

            if (string.IsNullOrEmpty(message))
                throw new ArgumentOutOfRangeException(parameterName);
            throw new ArgumentOutOfRangeException(parameterName, message);
        }