ProtoPreconditions.cs 3.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. #region Copyright notice and license
  2. // Protocol Buffers - Google's data interchange format
  3. // Copyright 2008 Google Inc. All rights reserved.
  4. // https://developers.google.com/protocol-buffers/
  5. //
  6. // Redistribution and use in source and binary forms, with or without
  7. // modification, are permitted provided that the following conditions are
  8. // met:
  9. //
  10. // * Redistributions of source code must retain the above copyright
  11. // notice, this list of conditions and the following disclaimer.
  12. // * Redistributions in binary form must reproduce the above
  13. // copyright notice, this list of conditions and the following disclaimer
  14. // in the documentation and/or other materials provided with the
  15. // distribution.
  16. // * Neither the name of Google Inc. nor the names of its
  17. // contributors may be used to endorse or promote products derived from
  18. // this software without specific prior written permission.
  19. //
  20. // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  21. // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  22. // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  23. // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  24. // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  25. // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  26. // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  27. // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  28. // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  29. // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  30. // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  31. #endregion
  32. using System;
  33. namespace Google.Protobuf
  34. {
  35. /// <summary>
  36. /// Helper methods for throwing exceptions when preconditions are not met.
  37. /// </summary>
  38. /// <remarks>
  39. /// This class is used internally and by generated code; it is not particularly
  40. /// expected to be used from application code, although nothing prevents it
  41. /// from being used that way.
  42. /// </remarks>
  43. public static class ProtoPreconditions
  44. {
  45. /// <summary>
  46. /// Throws an ArgumentNullException if the given value is null, otherwise
  47. /// return the value to the caller.
  48. /// </summary>
  49. public static T CheckNotNull<T>(T value, string name) where T : class
  50. {
  51. if (value == null)
  52. {
  53. throw new ArgumentNullException(name);
  54. }
  55. return value;
  56. }
  57. /// <summary>
  58. /// Throws an ArgumentNullException if the given value is null, otherwise
  59. /// return the value to the caller.
  60. /// </summary>
  61. /// <remarks>
  62. /// This is equivalent to <see cref="CheckNotNull{T}(T, string)"/> but without the type parameter
  63. /// constraint. In most cases, the constraint is useful to prevent you from calling CheckNotNull
  64. /// with a value type - but it gets in the way if either you want to use it with a nullable
  65. /// value type, or you want to use it with an unconstrained type parameter.
  66. /// </remarks>
  67. internal static T CheckNotNullUnconstrained<T>(T value, string name)
  68. {
  69. if (value == null)
  70. {
  71. throw new ArgumentNullException(name);
  72. }
  73. return value;
  74. }
  75. }
  76. }