/* Copyright 2010-2016 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 NET45
[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
}
}