linux-packaging-mono/mcs/class/corlib/System.Globalization/StringInfo.cs

//
// System.Globalization.StringInfo.cs
//
// Author:
//	Dick Porter (dick@ximian.com)
//
// (C) 2002 Ximian, Inc.
// (C) 2004 Novell, Inc.
//

//
// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
// 
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
// 
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//

using System.Collections;
using System.Runtime.InteropServices;

namespace System.Globalization {

	[Serializable]
	[ComVisible(true)]
	public class StringInfo {

		public StringInfo () : this (string.Empty)
		{
		}

		string s;
		int length;

		public StringInfo (string value)
		{
			// Argument check in property
			String = value;
		}

		[ComVisible (false)]
		public override bool Equals (object value)
		{
			StringInfo other = value as StringInfo;
			return other != null && s == other.s;
		}

		[ComVisible (false)]
		public override int GetHashCode ()
		{
			return s.GetHashCode ();
		}

		public int LengthInTextElements {
			get {
				if (length < 0) {
					length = 0;
					for (int idx = 0; idx < s.Length; length++)
						idx += GetNextTextElementLength (s, idx);
				}
				return length;
			}
		}

		public string String {
			get { return s; }
			set {
				if (value == null)
					throw new ArgumentNullException ("value");
				length = -1;
				s = value;
			}
		}

		public string SubstringByTextElements (int startingTextElement)
		{
			if (startingTextElement < 0 || s.Length == 0)
				throw new ArgumentOutOfRangeException ("startingTextElement");
			int idx = 0;
			for (int i = 0; i < startingTextElement; i++) {
				if (idx >= s.Length)
					throw new ArgumentOutOfRangeException ("startingTextElement");
				idx += GetNextTextElementLength (s, idx);
			}
			return s.Substring (idx);
		}

		public string SubstringByTextElements (int startingTextElement, int lengthInTextElements)
		{
			if (startingTextElement < 0 || s.Length == 0)
				throw new ArgumentOutOfRangeException ("startingTextElement");
			if (lengthInTextElements < 0)
				throw new ArgumentOutOfRangeException ("lengthInTextElements");
			int idx = 0;
			for (int i = 0; i < startingTextElement; i++) {
				if (idx >= s.Length)
					throw new ArgumentOutOfRangeException ("startingTextElement");
				idx += GetNextTextElementLength (s, idx);
			}
			int start = idx;
			for (int i = 0; i < lengthInTextElements; i++) {
				if (idx >= s.Length)
					throw new ArgumentOutOfRangeException ("lengthInTextElements");
				idx += GetNextTextElementLength (s, idx);
			}
			return s.Substring (start, idx - start);
		}

		public static string GetNextTextElement(string str)
		{
			if(str == null || str.Length == 0) {
				throw new ArgumentNullException("string is null");
			}
			return(GetNextTextElement (str, 0));
		}

		public static string GetNextTextElement(string str, int index)
		{
			int len = GetNextTextElementLength (str, index);
			return len != 1 ? str.Substring (index, len) : new string (str [index], 1);
		}
		
		static int GetNextTextElementLength(string str, int index)
		{
			if(str == null) {
				throw new ArgumentNullException("string is null");
			}

			if(index >= str.Length)
				return 0;
			if(index < 0)
				throw new ArgumentOutOfRangeException ("Index is not valid");

			/* Find the next base character, surrogate
			 * pair or combining character sequence
			 */

			char ch = str[index];
			UnicodeCategory cat = char.GetUnicodeCategory (ch);

			if (cat == UnicodeCategory.Surrogate) {
				/* Check that it's a high surrogate
				 * followed by a low surrogate
				 */
				if (ch >= 0xD800 && ch <= 0xDBFF) {
					if ((index + 1) < str.Length &&
					    str[index + 1] >= 0xDC00 &&
					    str[index + 1] <= 0xDFFF) {
						/* A valid surrogate pair */
						return 2;
					} else {
						/* High surrogate on its own */
						return 1;
					}
				} else {
					/* Low surrogate on its own */
					return 1;
				}
			} else {
				/* Look for a base character, which
				 * may or may not be followed by a
				 * series of combining characters
				 */

				if (cat == UnicodeCategory.NonSpacingMark ||
				    cat == UnicodeCategory.SpacingCombiningMark ||
				    cat == UnicodeCategory.EnclosingMark) {
					/* Not a base character */
					return 1;
				}
				
				int count = 1;

				while (index + count < str.Length) {
					cat = char.GetUnicodeCategory (str[index + count]);
					if (cat != UnicodeCategory.NonSpacingMark &&
					    cat != UnicodeCategory.SpacingCombiningMark &&
					    cat != UnicodeCategory.EnclosingMark) {
						/* Finished the sequence */
						break;
					}
					count++;
				}

				return count;
			}
		}

		public static TextElementEnumerator GetTextElementEnumerator(string str)
		{
			if(str == null || str.Length == 0) {
				throw new ArgumentNullException("string is null");
			}
			return(new TextElementEnumerator (str, 0));
		}

		public static TextElementEnumerator GetTextElementEnumerator(string str, int index)
		{
			if(str == null) {
				throw new ArgumentNullException("string is null");
			}

			if(index < 0 || index >= str.Length) {
				throw new ArgumentOutOfRangeException ("Index is not valid");
			}
			
			return(new TextElementEnumerator (str, index));
		}
		
		public static int[] ParseCombiningCharacters(string str)
		{
			if(str == null) {
				throw new ArgumentNullException("string is null");
			}

			ArrayList indices = new ArrayList (str.Length);
			TextElementEnumerator tee = GetTextElementEnumerator (str);

			tee.Reset ();
			while(tee.MoveNext ()) {
				indices.Add (tee.ElementIndex);
			}

			return((int[])indices.ToArray (typeof (int)));
		}
	}
}