youys
/
Discord.Net
Not watched
1
0
Fork 0
Code
Releases 34 Wiki Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain
You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tree: 0554ac2442
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '0554ac2442'
${ noResults }
Discord.Net/src/Discord.Net.Core/Utils/Preconditions.cs

319 lines
34 KiB
Raw Blame History 

  1. using System;

  2. 

  3. namespace Discord

  4. {

  5.     internal static class Preconditions

  6.     {

  7.         #region Objects

  8.         /// <exception cref="ArgumentNullException"><paramref name="obj"/> must not be <see langword="null"/>.</exception>

  9.         public static void NotNull<T>(T obj, string name, string msg = null) where T : class { if (obj == null) throw CreateNotNullException(name, msg); }

  10.         /// <exception cref="ArgumentNullException"><paramref name="obj"/> must not be <see langword="null"/>.</exception>

  11.         public static void NotNull<T>(Optional<T> obj, string name, string msg = null) where T : class { if (obj.IsSpecified && obj.Value == null) throw CreateNotNullException(name, msg); }

  12. 

  13.         private static ArgumentNullException CreateNotNullException(string name, string msg)

  14.         {

  15.             if (msg == null) return new ArgumentNullException(paramName: name);

  16.             else return new ArgumentNullException(paramName: name, message: msg);

  17.         }

  18.         #endregion

  19. 

  20.         #region Strings

  21.         /// <exception cref="ArgumentException"><paramref name="obj"/> cannot be blank.</exception>

  22.         public static void NotEmpty(string obj, string name, string msg = null) { if (obj.Length == 0) throw CreateNotEmptyException(name, msg); }

  23.         /// <exception cref="ArgumentException"><paramref name="obj"/> cannot be blank.</exception>

  24.         public static void NotEmpty(Optional<string> obj, string name, string msg = null) { if (obj.IsSpecified && obj.Value.Length == 0) throw CreateNotEmptyException(name, msg); }

  25.         /// <exception cref="ArgumentException"><paramref name="obj"/> cannot be blank.</exception>

  26.         /// <exception cref="ArgumentNullException"><paramref name="obj"/> must not be <see langword="null"/>.</exception>

  27.         public static void NotNullOrEmpty(string obj, string name, string msg = null)

  28.         {

  29.             if (obj == null) throw CreateNotNullException(name, msg);

  30.             if (obj.Length == 0) throw CreateNotEmptyException(name, msg);

  31.         }

  32.         /// <exception cref="ArgumentException"><paramref name="obj"/> cannot be blank.</exception>

  33.         /// <exception cref="ArgumentNullException"><paramref name="obj"/> must not be <see langword="null"/>.</exception>

  34.         public static void NotNullOrEmpty(Optional<string> obj, string name, string msg = null)

  35.         {

  36.             if (obj.IsSpecified)

  37.             {

  38.                 if (obj.Value == null) throw CreateNotNullException(name, msg);

  39.                 if (obj.Value.Length == 0) throw CreateNotEmptyException(name, msg);

  40.             }

  41.         }

  42.         /// <exception cref="ArgumentException"><paramref name="obj"/> cannot be blank.</exception>

  43.         /// <exception cref="ArgumentNullException"><paramref name="obj"/> must not be <see langword="null"/>.</exception>

  44.         public static void NotNullOrWhitespace(string obj, string name, string msg = null)

  45.         {

  46.             if (obj == null) throw CreateNotNullException(name, msg);

  47.             if (obj.Trim().Length == 0) throw CreateNotEmptyException(name, msg);

  48.         }

  49.         /// <exception cref="ArgumentException"><paramref name="obj"/> cannot be blank.</exception>

  50.         /// <exception cref="ArgumentNullException"><paramref name="obj"/> must not be <see langword="null"/>.</exception>

  51.         public static void NotNullOrWhitespace(Optional<string> obj, string name, string msg = null)

  52.         {

  53.             if (obj.IsSpecified)

  54.             {

  55.                 if (obj.Value == null) throw CreateNotNullException(name, msg);

  56.                 if (obj.Value.Trim().Length == 0) throw CreateNotEmptyException(name, msg);

  57.             }

  58.         }        

  59. 

  60.         private static ArgumentException CreateNotEmptyException(string name, string msg)

  61.             => new ArgumentException(message: msg ?? "Argument cannot be blank.", paramName: name);

  62.         #endregion

  63. 

  64.         #region Numerics

  65.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  66.         public static void NotEqual(sbyte obj, sbyte value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  67.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  68.         public static void NotEqual(byte obj, byte value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  69.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  70.         public static void NotEqual(short obj, short value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  71.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  72.         public static void NotEqual(ushort obj, ushort value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  73.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  74.         public static void NotEqual(int obj, int value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  75.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  76.         public static void NotEqual(uint obj, uint value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  77.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  78.         public static void NotEqual(long obj, long value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  79.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  80.         public static void NotEqual(ulong obj, ulong value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  81.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  82.         public static void NotEqual(Optional<sbyte> obj, sbyte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  83.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  84.         public static void NotEqual(Optional<byte> obj, byte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  85.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  86.         public static void NotEqual(Optional<short> obj, short value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  87.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  88.         public static void NotEqual(Optional<ushort> obj, ushort value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  89.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  90.         public static void NotEqual(Optional<int> obj, int value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  91.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  92.         public static void NotEqual(Optional<uint> obj, uint value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  93.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  94.         public static void NotEqual(Optional<long> obj, long value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  95.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  96.         public static void NotEqual(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  97.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  98.         public static void NotEqual(sbyte? obj, sbyte value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  99.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  100.         public static void NotEqual(byte? obj, byte value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  101.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  102.         public static void NotEqual(short? obj, short value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  103.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  104.         public static void NotEqual(ushort? obj, ushort value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  105.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  106.         public static void NotEqual(int? obj, int value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  107.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  108.         public static void NotEqual(uint? obj, uint value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  109.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  110.         public static void NotEqual(long? obj, long value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  111.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  112.         public static void NotEqual(ulong? obj, ulong value, string name, string msg = null) { if (obj == value) throw CreateNotEqualException(name, msg, value); }

  113.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  114.         public static void NotEqual(Optional<sbyte?> obj, sbyte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  115.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  116.         public static void NotEqual(Optional<byte?> obj, byte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  117.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  118.         public static void NotEqual(Optional<short?> obj, short value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  119.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  120.         public static void NotEqual(Optional<ushort?> obj, ushort value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  121.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  122.         public static void NotEqual(Optional<int?> obj, int value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  123.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  124.         public static void NotEqual(Optional<uint?> obj, uint value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  125.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  126.         public static void NotEqual(Optional<long?> obj, long value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  127.         /// <exception cref="ArgumentException">Value may not be equal to <paramref name="value"/>.</exception>

  128.         public static void NotEqual(Optional<ulong?> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value == value) throw CreateNotEqualException(name, msg, value); }

  129. 

  130.         private static ArgumentException CreateNotEqualException<T>(string name, string msg, T value)

  131.             => new ArgumentException(message: msg ?? $"Value may not be equal to {value}.", paramName: name);

  132.         

  133.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  134.         public static void AtLeast(sbyte obj, sbyte value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  135.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  136.         public static void AtLeast(byte obj, byte value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  137.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  138.         public static void AtLeast(short obj, short value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  139.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  140.         public static void AtLeast(ushort obj, ushort value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  141.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  142.         public static void AtLeast(int obj, int value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  143.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  144.         public static void AtLeast(uint obj, uint value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  145.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  146.         public static void AtLeast(long obj, long value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  147.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  148.         public static void AtLeast(ulong obj, ulong value, string name, string msg = null) { if (obj < value) throw CreateAtLeastException(name, msg, value); }

  149.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  150.         public static void AtLeast(Optional<sbyte> obj, sbyte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  151.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  152.         public static void AtLeast(Optional<byte> obj, byte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  153.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  154.         public static void AtLeast(Optional<short> obj, short value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  155.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  156.         public static void AtLeast(Optional<ushort> obj, ushort value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  157.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  158.         public static void AtLeast(Optional<int> obj, int value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  159.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  160.         public static void AtLeast(Optional<uint> obj, uint value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  161.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  162.         public static void AtLeast(Optional<long> obj, long value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  163.         /// <exception cref="ArgumentException">Value must be at least <paramref name="value"/>.</exception>

  164.         public static void AtLeast(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value < value) throw CreateAtLeastException(name, msg, value); }

  165. 

  166.         private static ArgumentException CreateAtLeastException<T>(string name, string msg, T value)

  167.             => new ArgumentException(message: msg ?? $"Value must be at least {value}.", paramName: name);

  168.         

  169.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  170.         public static void GreaterThan(sbyte obj, sbyte value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  171.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  172.         public static void GreaterThan(byte obj, byte value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  173.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  174.         public static void GreaterThan(short obj, short value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  175.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  176.         public static void GreaterThan(ushort obj, ushort value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  177.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  178.         public static void GreaterThan(int obj, int value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  179.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  180.         public static void GreaterThan(uint obj, uint value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  181.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  182.         public static void GreaterThan(long obj, long value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  183.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  184.         public static void GreaterThan(ulong obj, ulong value, string name, string msg = null) { if (obj <= value) throw CreateGreaterThanException(name, msg, value); }

  185.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  186.         public static void GreaterThan(Optional<sbyte> obj, sbyte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  187.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  188.         public static void GreaterThan(Optional<byte> obj, byte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  189.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  190.         public static void GreaterThan(Optional<short> obj, short value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  191.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  192.         public static void GreaterThan(Optional<ushort> obj, ushort value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  193.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  194.         public static void GreaterThan(Optional<int> obj, int value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  195.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  196.         public static void GreaterThan(Optional<uint> obj, uint value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  197.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  198.         public static void GreaterThan(Optional<long> obj, long value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  199.         /// <exception cref="ArgumentException">Value must be greater than <paramref name="value"/>.</exception>

  200.         public static void GreaterThan(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value <= value) throw CreateGreaterThanException(name, msg, value); }

  201. 

  202.         private static ArgumentException CreateGreaterThanException<T>(string name, string msg, T value)

  203.             => new ArgumentException(message: msg ?? $"Value must be greater than {value}.", paramName: name);

  204.         

  205.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  206.         public static void AtMost(sbyte obj, sbyte value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  207.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  208.         public static void AtMost(byte obj, byte value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  209.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  210.         public static void AtMost(short obj, short value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  211.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  212.         public static void AtMost(ushort obj, ushort value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  213.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  214.         public static void AtMost(int obj, int value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  215.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  216.         public static void AtMost(uint obj, uint value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  217.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  218.         public static void AtMost(long obj, long value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  219.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  220.         public static void AtMost(ulong obj, ulong value, string name, string msg = null) { if (obj > value) throw CreateAtMostException(name, msg, value); }

  221.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  222.         public static void AtMost(Optional<sbyte> obj, sbyte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  223.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  224.         public static void AtMost(Optional<byte> obj, byte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  225.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  226.         public static void AtMost(Optional<short> obj, short value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  227.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  228.         public static void AtMost(Optional<ushort> obj, ushort value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  229.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  230.         public static void AtMost(Optional<int> obj, int value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  231.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  232.         public static void AtMost(Optional<uint> obj, uint value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  233.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  234.         public static void AtMost(Optional<long> obj, long value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  235.         /// <exception cref="ArgumentException">Value must be at most <paramref name="value"/>.</exception>

  236.         public static void AtMost(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value > value) throw CreateAtMostException(name, msg, value); }

  237. 

  238.         private static ArgumentException CreateAtMostException<T>(string name, string msg, T value)

  239.             => new ArgumentException(message: msg ?? $"Value must be at most {value}.", paramName: name);

  240.         

  241.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  242.         public static void LessThan(sbyte obj, sbyte value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  243.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  244.         public static void LessThan(byte obj, byte value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  245.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  246.         public static void LessThan(short obj, short value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  247.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  248.         public static void LessThan(ushort obj, ushort value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  249.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  250.         public static void LessThan(int obj, int value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  251.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  252.         public static void LessThan(uint obj, uint value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  253.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  254.         public static void LessThan(long obj, long value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  255.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  256.         public static void LessThan(ulong obj, ulong value, string name, string msg = null) { if (obj >= value) throw CreateLessThanException(name, msg, value); }

  257.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  258.         public static void LessThan(Optional<sbyte> obj, sbyte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  259.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  260.         public static void LessThan(Optional<byte> obj, byte value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  261.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  262.         public static void LessThan(Optional<short> obj, short value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  263.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  264.         public static void LessThan(Optional<ushort> obj, ushort value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  265.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  266.         public static void LessThan(Optional<int> obj, int value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  267.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  268.         public static void LessThan(Optional<uint> obj, uint value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  269.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  270.         public static void LessThan(Optional<long> obj, long value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  271.         /// <exception cref="ArgumentException">Value must be less than <paramref name="value"/>.</exception>

  272.         public static void LessThan(Optional<ulong> obj, ulong value, string name, string msg = null) { if (obj.IsSpecified && obj.Value >= value) throw CreateLessThanException(name, msg, value); }

  273. 

  274.         private static ArgumentException CreateLessThanException<T>(string name, string msg, T value)

  275.             => new ArgumentException(message: msg ?? $"Value must be less than {value}.", paramName: name);

  276.         #endregion

  277. 

  278.         #region Bulk Delete

  279.         /// <exception cref="ArgumentOutOfRangeException">Messages are younger than 2 weeks.</exception>

  280.         public static void YoungerThanTwoWeeks(ulong[] collection, string name)

  281.         {

  282.             var minimum = SnowflakeUtils.ToSnowflake(DateTimeOffset.UtcNow.Subtract(TimeSpan.FromDays(14)));

  283.             for (var i = 0; i < collection.Length; i++)

  284.             {

  285.                 if (collection[i] == 0) continue;

  286.                 if (collection[i] <= minimum)

  287.                     throw new ArgumentOutOfRangeException(name, "Messages must be younger than two weeks old.");

  288.             }

  289.         }

  290.         /// <exception cref="ArgumentException">The everyone role cannot be assigned to a user.</exception>

  291.         public static void NotEveryoneRole(ulong[] roles, ulong guildId, string name)

  292.         {

  293.             for (var i = 0; i < roles.Length; i++)

  294.             {

  295.                 if (roles[i] == guildId)

  296.                     throw new ArgumentException(message: "The everyone role cannot be assigned to a user.", paramName: name);

  297.             }

  298.         }

  299.         #endregion

  300. 

  301.         #region SlashCommandOptions

  302. 

  303.         /// <exception cref="ArgumentNullException"><paramref name="description"/> or <paramref name="name"/> is null.</exception>

  304.         /// <exception cref="ArgumentException"><paramref name="description"/> or <paramref name="name"/> are either empty or their length exceed limits.</exception>

  305.         public static void Options(string name, string description)

  306.         {

  307.             // Make sure the name matches the requirements from discord

  308.             NotNullOrEmpty(name, nameof(name));

  309.             NotNullOrEmpty(description, nameof(description));

  310.             AtLeast(name.Length, 1, nameof(name));

  311.             AtMost(name.Length, SlashCommandBuilder.MaxNameLength, nameof(name));

  312.             AtLeast(description.Length, 1, nameof(description));

  313.             AtMost(description.Length, SlashCommandBuilder.MaxDescriptionLength, nameof(description));

  314.         }

  315. 

  316.         #endregion

  317.     }

  318. }
Please read the following content carefully:

Dear OpenI User

Thank you for your continuous support to the Openl Qizhi Community AI Collaboration Platform. In order to protect your usage rights and ensure network security, we updated the Openl Qizhi Community AI Collaboration Platform Usage Agreement in January 2024. The updated agreement specifies that users are prohibited from using intranet penetration tools. After you click "Agree and continue", you can continue to use our services. Thank you for your cooperation and understanding.

For more agreement content, please refer to the《Openl Qizhi Community AI Collaboration Platform Usage Agreement》

Agree and continue
Disagree, exit