/* Copyright 2010-present 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.
///
#if NET452
[Serializable]
#endif
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()
{
}
// 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 properties
///
/// Gets the BsonType of this BsonValue.
///
public override BsonType BsonType
{
get { return BsonType.Undefined; }
}
// 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";
}
}
}