/// <summary> /// Creates a random <see langword="long"/> value within the specified range using a uniform /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <returns>A random <see langword="long"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static long AnyInt64(this IAnonymousData anon, long minimum, long maximum) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, long.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return(anon.AnyInt64(minimum, maximum, Distribution.Uniform)); }
/// <summary> /// Creates a <see langword="long"/> value within the specified ranges using the specified factory /// and distribution algorithm. /// </summary> /// <param name="factory">The factory used to create the <see langword="long"/> value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <param name="ranges">The ranges the value must be within.</param> /// <returns>A random <see langword="long"/> value that falls within the specified ranges.</returns> public static long CreateLongFromRanges(IAnonymousData factory, Distribution distribution, params Range[] ranges) { Argument.NotNull(factory, nameof(factory)); Argument.NotNull(ranges, nameof(ranges)); if (ranges.Length == 0) { throw new ArgumentException("The ranges must not be empty.", nameof(ranges)); } VerifyRanges(ranges); var length = ranges.Sum(r => r.Length); var index = factory.AnyInt64(0, length - 1, distribution); for (var i = 0; i < ranges.Length; ++i) { if (index < ranges[i].Length) { var result = ranges[i].Minimum + index; Debug.Assert(result >= ranges[i].Minimum && result <= ranges[i].Maximum, "Invalid range value."); return(result); } index -= ranges[i].Length; } throw new InvalidOperationException(); }
/// <summary> /// Creates an anonymous <see langword="byte"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="byte"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static byte AnyByte(this IAnonymousData anon, byte minimum, byte maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, double.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return((byte)anon.AnyInt64(minimum, maximum, distribution)); }
/// <summary> /// Creates a random <see langword="int"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="int"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static int AnyInt32(this IAnonymousData anon, int minimum, int maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, int.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return((int)anon.AnyInt64(minimum, maximum, distribution)); }
/// <summary> /// Creates an anonymous <see langword="char"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="char"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> public static char AnyChar(this IAnonymousData anon, char minimum, char maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, char.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); return((char)anon.AnyInt64(minimum, maximum, distribution)); }
/// <summary> /// Creates a random <see langword="TimeSpan"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="TimeSpan"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static TimeSpan AnyTimeSpan(this IAnonymousData anon, TimeSpan minimum, TimeSpan maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, TimeSpan.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); long ticks = anon.AnyInt64(minimum.Ticks, maximum.Ticks, distribution); return(new TimeSpan(ticks)); }
/// <summary> /// Creates a random <see langword="DateTime"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="DateTime"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is null.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static DateTime AnyDateTime(this IAnonymousData anon, DateTime minimum, DateTime maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, DateTime.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); var ticks = anon.AnyInt64(minimum.Ticks, maximum.Ticks, distribution); return(new DateTime(ticks)); }
/// <summary> /// Creates a random <see langword="DateTimeOffset"/> value within the specified range using the specified /// distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="minimum">The minimum value.</param> /// <param name="maximum">The maximum value.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="DateTimeOffset"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <exception cref="ArgumentOutOfRangeException"><paramref name="maximum"/> is less than <paramref name="minimum"/>.</exception> public static DateTimeOffset AnyDateTimeOffset(this IAnonymousData anon, DateTimeOffset minimum, DateTimeOffset maximum, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); Argument.InRange(maximum, minimum, DateTimeOffset.MaxValue, nameof(maximum), "The maximum value must be greater than the minimum value."); var ticks = anon.AnyInt64(minimum.Ticks, maximum.Ticks, distribution); var offset = Offsets[anon.AnyInt32(0, Offsets.Length)]; return(new DateTimeOffset(ticks, offset)); }
/// <summary> /// Creates a random positive <see langword="long"/> value. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <returns>A random positive <see langword="long"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> /// <remarks> /// This method may return a zero value, which strictly makes this "any non-negative" from a mathematical /// perspective, but the term "positive" is used because this is what many would expect. /// </remarks> public static long AnyPositiveInt64(this IAnonymousData anon) { Argument.NotNull(anon, nameof(anon)); return(anon.AnyInt64(0, long.MaxValue, Distribution.Uniform)); }
/// <summary> /// Creates a random <see langword="long"/> value using the specified distribution algorithm. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <param name="distribution">The distribution algorithm to use.</param> /// <returns>A random <see langword="long"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> public static long AnyInt64(this IAnonymousData anon, Distribution distribution) { Argument.NotNull(anon, nameof(anon)); return(anon.AnyInt64(long.MinValue, long.MaxValue, distribution)); }
/// <summary> /// Creates a random positive <see langword="long"/> value. /// </summary> /// <param name="anon">The anonymous data provider to use.</param> /// <returns>A random positive <see langword="long"/> value.</returns> /// <exception cref="ArgumentNullException"><paramref name="anon"/> is <c>null</c>.</exception> public static long AnyNegativeInt64(this IAnonymousData anon) { Argument.NotNull(anon, nameof(anon)); return(anon.AnyInt64(long.MinValue, -1, Distribution.Uniform)); }