/* 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; using MongoDB.Bson.IO; namespace MongoDB.Bson { /// /// Represents a BSON string value. /// #if NET452 [Serializable] #endif public class BsonString : BsonValue, IComparable, IEquatable { // private static fields private static BsonString __emptyInstance = new BsonString(""); // private fields private readonly string _value; // constructors /// /// Initializes a new instance of the BsonString class. /// /// The value. public BsonString(string value) { if (value == null) { throw new ArgumentNullException("value"); } _value = value; } // public static properties /// /// Gets an instance of BsonString that represents an empty string. /// public static BsonString Empty { get { return __emptyInstance; } } // public properties /// /// Gets the BsonType of this BsonValue. /// public override BsonType BsonType { get { return BsonType.String; } } /// /// Gets the BsonString as a string. /// [Obsolete("Use Value instead.")] public override object RawValue { get { return _value; } } /// /// Gets the value of this BsonString. /// public string Value { get { return _value; } } // public operators /// /// Converts a string to a BsonString. /// /// A string. /// A BsonString. public static implicit operator BsonString(string value) { if (value != null && value.Length == 0) { return __emptyInstance; } return new BsonString(value); } /// /// Compares two BsonString values. /// /// The first BsonString. /// The other BsonString. /// True if the two BsonString values are not equal according to ==. public static bool operator !=(BsonString lhs, BsonString rhs) { return !(lhs == rhs); } /// /// Compares two BsonString values. /// /// The first BsonString. /// The other BsonString. /// True if the two BsonString values are equal according to ==. public static bool operator ==(BsonString lhs, BsonString rhs) { if (object.ReferenceEquals(lhs, null)) { return object.ReferenceEquals(rhs, null); } return lhs.Equals(rhs); } // public static methods /// /// Creates a new BsonString. /// /// An object to be mapped to a BsonString. /// A BsonString or null. public new static BsonString Create(object value) { if (value == null) { throw new ArgumentNullException("value"); } return (BsonString)BsonTypeMapper.MapToBsonValue(value, BsonType.String); } // public methods /// /// Compares this BsonString to another BsonString. /// /// The other BsonString. /// A 32-bit signed integer that indicates whether this BsonString is less than, equal to, or greather than the other. public int CompareTo(BsonString other) { if (other == null) { return 1; } return _value.CompareTo(other.Value); } /// /// Compares the BsonString to another BsonValue. /// /// The other BsonValue. /// A 32-bit signed integer that indicates whether this BsonString is less than, equal to, or greather than the other BsonValue. public override int CompareTo(BsonValue other) { if (other == null) { return 1; } var otherString = other as BsonString; if (otherString != null) { return _value.CompareTo(otherString.Value); } var otherSymbol = other as BsonSymbol; if (otherSymbol != null) { return _value.CompareTo(otherSymbol.Name); } return CompareTypeTo(other); } /// /// Compares this BsonString to another BsonString. /// /// The other BsonString. /// True if the two BsonString values are equal. public bool Equals(BsonString rhs) { if (object.ReferenceEquals(rhs, null) || GetType() != rhs.GetType()) { return false; } return _value == rhs._value; } /// /// Compares this BsonString to another object. /// /// The other object. /// True if the other object is a BsonString and equal to this one. public override bool Equals(object obj) { return Equals(obj as BsonString); // works even if obj is null or of a different type } /// /// Gets the hash code. /// /// The hash code. public override int GetHashCode() { // see Effective Java by Joshua Bloch int hash = 17; hash = 37 * hash + BsonType.GetHashCode(); hash = 37 * hash + _value.GetHashCode(); return hash; } /// /// Converts this BsonValue to a Boolean (using the JavaScript definition of truthiness). /// /// A Boolean. public override bool ToBoolean() { return _value != ""; } /// public override decimal ToDecimal() { return JsonConvert.ToDecimal(_value); } /// public override Decimal128 ToDecimal128() { return JsonConvert.ToDecimal128(_value); } /// /// Converts this BsonValue to a Double. /// /// A Double. public override double ToDouble() { return JsonConvert.ToDouble(_value); } /// /// Converts this BsonValue to an Int32. /// /// An Int32. public override int ToInt32() { return JsonConvert.ToInt32(_value); } /// /// Converts this BsonValue to an Int64. /// /// An Int32. public override long ToInt64() { return JsonConvert.ToInt64(_value); } /// /// Returns a string representation of the value. /// /// A string representation of the value. public override string ToString() { return _value; } // protected methods /// protected override TypeCode IConvertibleGetTypeCodeImplementation() { return TypeCode.String; } /// protected override byte IConvertibleToByteImplementation(IFormatProvider provider) { return Convert.ToByte(_value, provider); } /// protected override bool IConvertibleToBooleanImplementation(IFormatProvider provider) { return Convert.ToBoolean(_value, provider); } /// protected override char IConvertibleToCharImplementation(IFormatProvider provider) { return Convert.ToChar(_value, provider); } /// protected override DateTime IConvertibleToDateTimeImplementation(IFormatProvider provider) { return Convert.ToDateTime(_value, provider); } /// protected override decimal IConvertibleToDecimalImplementation(IFormatProvider provider) { return Convert.ToDecimal(_value, provider); } /// protected override double IConvertibleToDoubleImplementation(IFormatProvider provider) { return Convert.ToDouble(_value, provider); } /// protected override short IConvertibleToInt16Implementation(IFormatProvider provider) { return Convert.ToInt16(_value, provider); } /// protected override int IConvertibleToInt32Implementation(IFormatProvider provider) { return Convert.ToInt32(_value, provider); } /// protected override long IConvertibleToInt64Implementation(IFormatProvider provider) { return Convert.ToInt64(_value, provider); } /// #pragma warning disable 3002 protected override sbyte IConvertibleToSByteImplementation(IFormatProvider provider) { return Convert.ToSByte(_value, provider); } #pragma warning restore /// protected override float IConvertibleToSingleImplementation(IFormatProvider provider) { return Convert.ToSingle(_value, provider); } /// protected override string IConvertibleToStringImplementation(IFormatProvider provider) { return _value; } /// #pragma warning disable 3002 protected override ushort IConvertibleToUInt16Implementation(IFormatProvider provider) { return Convert.ToUInt16(_value, provider); } #pragma warning restore /// #pragma warning disable 3002 protected override uint IConvertibleToUInt32Implementation(IFormatProvider provider) { return Convert.ToUInt32(_value, provider); } #pragma warning restore /// #pragma warning disable 3002 protected override ulong IConvertibleToUInt64Implementation(IFormatProvider provider) { return Convert.ToUInt64(_value, provider); } #pragma warning restore } }