public static string IsNotEqualTo(string value, string notExpected, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => Ensure.String.IsNotEqualTo(value, notExpected, paramName, optsFn);
internal Exception ArgumentOutOfRangeException <TValue>([NotNull] string defaultMessage, string paramName, TValue value, OptsFn optsFn = null)
{
if (optsFn != null)
{
var opts = optsFn(new EnsureOptions());
if (opts.CustomException != null)
{
return(opts.CustomException);
}
if (opts.CustomMessage != null)
{
return(new ArgumentOutOfRangeException(paramName, value, opts.CustomMessage));
}
}
return(new ArgumentOutOfRangeException(paramName, value, defaultMessage));
}
public static bool IsFalse(bool value, [InvokerParameterName] string paramName = Param.DefaultName, OptsFn optsFn = null) => Ensure.Bool.IsFalse(value, paramName, optsFn);
public IDictionary <TKey, TValue> SizeIs <TKey, TValue>([ValidatedNotNull] IDictionary <TKey, TValue> value, long expected, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName);
if (value.Count != expected)
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Collections_SizeIs_Failed, expected, value.Count),
paramName,
optsFn);
}
return(value);
}
public T[] HasAny <T>([ValidatedNotNull] T[] value, Func <T, bool> predicate, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName);
if (!value.Any(predicate))
{
throw Ensure.ExceptionFactory.ArgumentException(
ExceptionMessages.Collections_Any_Failed,
paramName,
optsFn);
}
return(value);
}
public string IsNotEmpty(string value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
if (value?.Length == 0)
{
throw Ensure.ExceptionFactory.ArgumentException(ExceptionMessages.Strings_IsNotEmpty_Failed, paramName, optsFn);
}
return(value);
}
public T[] SizeIs <T>([ValidatedNotNull] T[] value, long expected, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName);
#if NET452
if (value.LongLength != expected)
#else
if (value.Length != expected)
#endif
{ throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Collections_SizeIs_Failed, expected, value.Length),
paramName,
optsFn); }
return(value);
}
public string IsNotNull([ValidatedNotNull] string value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName, optsFn);
return(value);
}
public string SizeIs([ValidatedNotNull] string value, int expected, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName, optsFn);
if (value.Length != expected)
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Strings_SizeIs_Failed, expected, value.Length),
paramName,
optsFn);
}
return(value);
}
public string Matches(string value, [RegexPattern] string match, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => Matches(value, new Regex(match), paramName, optsFn);
public string Matches(string value, Regex match, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
if (!match.IsMatch(value))
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Strings_Matches_Failed, value, match),
paramName,
optsFn);
}
return(value);
}
public static string IsAllLettersOrDigits([ValidatedNotNull, NotNull] string value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => Ensure.String.IsAllLettersOrDigits(value, paramName, optsFn);
public static string StartsWith([ValidatedNotNull, NotNull] string value, [NotNull] string expectedStartsWith, StringComparison comparisonType, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => Ensure.String.StartsWith(value, expectedStartsWith, comparisonType, paramName, optsFn);
public static Guid IsGuid([ValidatedNotNull, NotNull] string value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => Ensure.String.IsGuid(value, paramName, optsFn);
public string IsNotNullOrEmpty([ValidatedNotNull] string value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName, optsFn);
if (string.IsNullOrEmpty(value))
{
throw Ensure.ExceptionFactory.ArgumentException(ExceptionMessages.Strings_IsNotNullOrEmpty_Failed, paramName, optsFn);
}
return(value);
}
public string Is(string value, string expected, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => IsEqualTo(value, expected, paramName, optsFn);
public string IsNotEmptyOrWhiteSpace(string value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
if (value == null)
{
return(null);
}
if (value.Length == 0)
{
throw Ensure.ExceptionFactory.ArgumentException(ExceptionMessages.Strings_IsNotEmptyOrWhiteSpace_Failed, paramName, optsFn);
}
foreach (var t in value)
{
if (!Char.IsWhiteSpace(t))
{
return(value); //succeed and return as soon as we see a non-whitespace character
}
}
throw Ensure.ExceptionFactory.ArgumentException(ExceptionMessages.Strings_IsNotEmptyOrWhiteSpace_Failed, paramName, optsFn);
}
public string IsNot(string value, string notExpected, StringComparison comparison, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => IsNotEqualTo(value, notExpected, comparison, paramName, optsFn);
public string HasLengthBetween([ValidatedNotNull] string value, int minLength, int maxLength, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName, optsFn);
var length = value.Length;
if (length < minLength)
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Strings_HasLengthBetween_Failed_ToShort, minLength, maxLength, length),
paramName,
optsFn);
}
if (length > maxLength)
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Strings_HasLengthBetween_Failed_ToLong, minLength, maxLength, length),
paramName,
optsFn);
}
return(value);
}
public string IsNotEqualTo(string value, string notExpected, StringComparison comparison, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
if (StringEquals(value, notExpected, comparison))
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Strings_IsNotEqualTo_Failed, value, notExpected),
paramName,
optsFn);
}
return(value);
}
public T SizeIs <T>([ValidatedNotNull] T value, int expected, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) where T : class, ICollection
{
Ensure.Any.IsNotNull(value, paramName);
if (value.Count != expected)
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Collections_SizeIs_Failed, expected, value.Count),
paramName,
optsFn);
}
return(value);
}
public string IsGuid([ValidatedNotNull] string value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
if (!Guid.TryParse(value, out _))
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Strings_IsGuid_Failed, value),
paramName,
optsFn);
}
return(value);
}
public IDictionary <TKey, TValue> ContainsKey <TKey, TValue>([ValidatedNotNull] IDictionary <TKey, TValue> value, TKey expectedKey, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName);
if (!value.ContainsKey(expectedKey))
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Collections_ContainsKey_Failed, expectedKey),
paramName,
optsFn);
}
return(value);
}
public string StartsWith([ValidatedNotNull] string value, [NotNull] string expectedStartsWith, StringComparison comparison, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName, optsFn);
if (!value.StartsWith(expectedStartsWith, comparison))
{
throw Ensure.ExceptionFactory.ArgumentException(
string.Format(ExceptionMessages.Strings_StartsWith_Failed, value, expectedStartsWith),
paramName,
optsFn);
}
return(value);
}
public Exception ArgumentNullException(string defaultMessage, string paramName, OptsFn optsFn = null)
{
if (optsFn != null)
{
var opts = optsFn(new EnsureOptions());
if (opts.CustomExceptionFactory != null)
{
return(opts.CustomExceptionFactory(defaultMessage, paramName));
}
if (opts.CustomException != null)
{
return(opts.CustomException);
}
if (opts.CustomMessage != null)
{
return(new ArgumentNullException(paramName, opts.CustomMessage));
}
}
return(new ArgumentNullException(paramName, defaultMessage));
}
public string IsGte(string value, string limit, StringComparison comparison, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
if (StringIsLt(value, limit, comparison))
{
throw Ensure.ExceptionFactory.ArgumentOutOfRangeException(
string.Format(ExceptionMessages.Comp_IsNotGte, value, limit), paramName, value, optsFn);
}
return(value);
}
internal Exception ArgumentException([NotNull] string defaultMessage, string paramName, OptsFn optsFn = null)
{
if (optsFn != null)
{
var opts = optsFn(new EnsureOptions());
if (opts.CustomException != null)
{
return(opts.CustomException);
}
if (opts.CustomMessage != null)
{
return(new ArgumentException(opts.CustomMessage, paramName));
}
}
return(new ArgumentException(defaultMessage, paramName));
}
public string IsInRange(string value, string min, string max, StringComparison comparison, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
if (StringIsLt(value, min, comparison))
{
throw Ensure.ExceptionFactory.ArgumentOutOfRangeException(
string.Format(ExceptionMessages.Comp_IsNotInRange_ToLow, value, min), paramName, value, optsFn);
}
if (StringIsGt(value, max, comparison))
{
throw Ensure.ExceptionFactory.ArgumentOutOfRangeException(
string.Format(ExceptionMessages.Comp_IsNotInRange_ToHigh, value, max), paramName, value, optsFn);
}
return(value);
}
public IList <T> HasItems <T>([ValidatedNotNull] IList <T> value, [InvokerParameterName] string paramName = null, OptsFn optsFn = null)
{
Ensure.Any.IsNotNull(value, paramName);
if (value.Count == 0)
{
throw Ensure.ExceptionFactory.ArgumentException(
ExceptionMessages.Collections_HasItemsFailed,
paramName,
optsFn);
}
return(value);
}
public static string IsEqualTo(string value, string expected, StringComparison comparison, [InvokerParameterName] string paramName = null, OptsFn optsFn = null) => Ensure.String.IsEqualTo(value, expected, comparison, paramName, optsFn);
