/* Copyright 2010-2014 MongoDB Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System; namespace MongoDB.Bson { /// /// Represents the BSON undefined value. /// [Serializable] public class BsonUndefined : BsonValue, IComparable, IEquatable { // private static fields private static BsonUndefined __value = new BsonUndefined(); // constructors // private so only the singleton instance can be created private BsonUndefined() : base(BsonType.Undefined) { } // public operators /// /// Compares two BsonUndefined values. /// /// The first BsonUndefined. /// The other BsonUndefined. /// True if the two BsonUndefined values are not equal according to ==. public static bool operator !=(BsonUndefined lhs, BsonUndefined rhs) { return !(lhs == rhs); } /// /// Compares two BsonUndefined values. /// /// The first BsonUndefined. /// The other BsonUndefined. /// True if the two BsonUndefined values are equal according to ==. public static bool operator ==(BsonUndefined lhs, BsonUndefined rhs) { if (object.ReferenceEquals(lhs, null)) { return object.ReferenceEquals(rhs, null); } return lhs.Equals(rhs); } // public static properties /// /// Gets the singleton instance of BsonUndefined. /// public static BsonUndefined Value { get { return __value; } } // public methods /// /// Compares this BsonUndefined to another BsonUndefined. /// /// The other BsonUndefined. /// A 32-bit signed integer that indicates whether this BsonUndefined is less than, equal to, or greather than the other. public int CompareTo(BsonUndefined other) { if (other == null) { return 1; } return 0; // it's a singleton } /// /// Compares the BsonUndefined to another BsonValue. /// /// The other BsonValue. /// A 32-bit signed integer that indicates whether this BsonUndefined is less than, equal to, or greather than the other BsonValue. public override int CompareTo(BsonValue other) { if (other == null) { return 1; } if (other is BsonMinKey) { return 1; } if (other is BsonUndefined) { return 0; } return -1; } /// /// Compares this BsonUndefined to another BsonUndefined. /// /// The other BsonUndefined. /// True if the two BsonUndefined values are equal. public bool Equals(BsonUndefined rhs) { if (object.ReferenceEquals(rhs, null) || GetType() != rhs.GetType()) { return false; } return true; // it's a singleton } /// /// Compares this BsonUndefined to another object. /// /// The other object. /// True if the other object is a BsonUndefined and equal to this one. public override bool Equals(object obj) { return Equals(obj as BsonUndefined); // works even if obj is null or of a different type } /// /// Gets the hash code. /// /// The hash code. public override int GetHashCode() { return BsonType.GetHashCode(); } /// /// Converts this BsonValue to a Boolean (using the JavaScript definition of truthiness). /// /// A Boolean. public override bool ToBoolean() { return false; } /// /// Returns a string representation of the value. /// /// A string representation of the value. public override string ToString() { return "BsonUndefined"; } } }