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 33 using System; 34 35 namespace Google.Protobuf 36 { 37 /// <summary> 38 /// Helper methods for throwing exceptions when preconditions are not met. 39 /// </summary> 40 /// <remarks> 41 /// This class is used internally and by generated code; it is not particularly 42 /// expected to be used from application code, although nothing prevents it 43 /// from being used that way. 44 /// </remarks> 45 public static class ProtoPreconditions 46 { 47 /// <summary> 48 /// Throws an ArgumentNullException if the given value is null, otherwise 49 /// return the value to the caller. 50 /// </summary> 51 public static T CheckNotNull<T>(T value, string name) where T : class 52 { 53 if (value == null) 54 { 55 throw new ArgumentNullException(name); 56 } 57 return value; 58 } 59 60 /// <summary> 61 /// Throws an ArgumentNullException if the given value is null, otherwise 62 /// return the value to the caller. 63 /// </summary> 64 /// <remarks> 65 /// This is equivalent to <see cref="CheckNotNull{T}(T, string)"/> but without the type parameter 66 /// constraint. In most cases, the constraint is useful to prevent you from calling CheckNotNull 67 /// with a value type - but it gets in the way if either you want to use it with a nullable 68 /// value type, or you want to use it with an unconstrained type parameter. 69 /// </remarks> CheckNotNullUnconstrained(T value, string name)70 internal static T CheckNotNullUnconstrained<T>(T value, string name) 71 { 72 if (value == null) 73 { 74 throw new ArgumentNullException(name); 75 } 76 return value; 77 } 78 } 79 }