В этих полях логические значения true и false содержатся в удобочитае мой форме. Так, если вывести содержимое поля FalseString с помощью метода WriteLine(), то на экране появится строка "False".
В структуре Boolean реализованы следующие интерфейсы: IComparable, IComparable<bool>, IConvertible и IEquatable<bool>.
Таблица 21.10. Методы, определенные в структуре Boolean Метод Назначение public int CompareTo(bool value) Сравнивает логическое значение вызывающего объекта со значением параметра value. Возвращает нуль, если сравниваемые значения равны; отрицательное значение, если вызывающий объект имеет логическое значение false, а параметр value — логическое значение true; и, наконец, положительное значение, если вызывающий объект имеет логическое значение true, а параметр value — логическое значение false public int CompareTo(object obj) Сравнивает логическое значение вызывающего объекта со значением параметра obj. Возвращает нуль, если сравниваемые значения равны; отрицательное значение, если вызывающий объект имеет логическое значение false, а параметр obj — логическое значение true; и, наконец, положительное значение, если вызывающий объект имеет логическое значение true, а параметр obj — логическое значение false public bool Equals(bool obj) Возвращает логическое значение true, если значение вызывающего объекта равно значению параметра obj public override bool Equals(object obj) Возвращает логическое значение true, если значение вызывающего объекта равно значению параметра obj public override int GetHashCode() Возвращает хеш-код для вызывающего объекта public TypeCode GetTypeCode() Возвращает значение перечисления TypeCode для структуры Boolean, т.е. TypeCode.Boolean public static bool Parse(string s) Возвращает эквивалент типа bool символьной строки s. Если строка s не содержит ни поле Boolean. TrueString, ни поле Boolean.FalseString, то генерируется исключение FormatException, независимо от того, какими буквами набрано содержимое строки: прописными или строчными public override string ToString() Возвращает строковое представление значения вызывающего объекта, которое должно быть либо значением поля TrueString, либо значением поля FalseString public string ToString(IFormatProvider provider) Возвращает строковое представление значения вызывающего объекта, которое должно быть либо значением поля TrueString, либо значением поля FalseString. При этом параметр provider игнорируется public static bool TryParse(string s, out bool result) Предпринимает попытку преобразовать символ из строки s в его эквивалентное значение типа bool. При успешной попытке это значение сохраняется в параметре result и возвращается логическое значение true. Если же строка s не содержит ни поле Boolean. TrueString, ни поле Boolean.FalseString, то возвращается логическое значение false, независимо от того, какими буквами набрано содержимое строки: прописными или строчными, в отличие от метода Parse(), который генерирует исключение в аналогичной ситуации Класс Array
Класс Array относится к числу наиболее часто используемых в пространстве имен System. Он является базовым классом для всех массивов в С#. Следовательно, его ме тоды можно применять к массивам любого встроенного в C# типа или же к массивам определяемого пользователем типа. Свойства, определенные в классе Array, перечис лены в табл. 21.11, а методы — в табл. 21.12.
В классе Array реализуются следующие интерфейсы: ICloneable, ICollection, IEnumerable, IStructuralComparable, IStructuralEquatable, а также IList. Все интерфейсы, кроме ICloneable, определены в пространстве имен System. Collections, подробнее рассматриваемом в главе 25.
В ряде методов данного класса используется параметр типа IComparer или IComparer<T>. Интерфейс IComparer находится в пространстве имен System. Collections. В нем определяется метод Compare() для сравнения значений двух объектов, как показано ниже. int Compare(object х, object у)
Этот метод возвращает значение больше нуля, если х больше у; значение меньше нудя, если х меньше у; и, наконец, нулевое значение, если оба значения равны. Интерфейс IComparer находится в пространстве имен System.Collections. Generic. В нем определяется метод Compare(), общая форма которого приведена ниже. int Compare(Т х, Т у)
Он действует таким же образом, как и его необобщенный аналог, возвращая значе ние больше нуля, если х больше у значение меньше нуля, если х меньше у, и, наконец, нулевое значение, если оба значения равны. Преимущество интерфейса IComparer заключается в том, что он обеспечивает типовую безопасность. Ведь в этом случае тип обрабатываемых данных указывается явным образом, а следовательно, никакого при ведения типов не требуется.
В последующих разделах демонстрируется ряд наиболее распространенных опера ций с массивами.
Таблица 21.11. Свойства, определенные в классе Array Свойство Назначение public bool IsFixedSize { get; } Доступно только для чтения. Принимает логическое значение true, если массив имеет фиксированный размер, и логическое значение false, если массив может изменять его динамически public bool IsReadOnly { get; } Доступно только для чтения. Принимает логическое значение true, если объект класса Array предназначен только для чтения, а иначе — логическое значение false. Для массивов это свойство всегда имеет логическое значение true public bool IsSynchronized { get; } Доступно только для чтения. Принимает логическое значение true, если массив можно безопасно использовать в многопоточной среде, а иначе — логическое значение false. Для массивов это свойство всегда имеет логическое значение true public int Length { get; } Доступно только для чтения. Имеет тип int и содержит количество элементов в массиве public long LongLength { get; } Доступно только для чтения. Имеет тип long и содержит количество элементов в массиве public int Rank { get; } Доступно только для чтения. Содержит размерность массива public object SyncRoot { get; } Доступно только для чтения. Содержит объект, предназначенный для синхронизации доступа к массиву
Таблица 21.12. Методы, определенные в классе Array Метод Назначение public static ReadOnlyCollection<T> AsReadOnly<T>(T[] array) Возвращает доступную только для чтения коллекцию, которая включает в себя массив, определяемый параметром array public static int BinarySearch(Array array, object value) Осуществляет поиск значения value в массиве array. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static int BinarySearch<T>(T[] array, T value) Осуществляет поиск значения value в массиве array. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static int BinarySearch(Array array, object value, IComparer comparer) Осуществляет поиск значения value в массиве, определяемом параметром array, используя способ сравнения, задаваемый параметром comparer. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static int BinarySearch<T>(T[] array, T value, IComparer<T> comparer) Осуществляет поиск значения value в массиве array, используя способ сравнения, задаваемый параметром comparer. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static int BinarySearch(Array array, int index, int length, object value) Осуществляет поиск значения value в части массива array. Поиск начинается с индекса, задаваемого параметром index, и охватывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static int BinarySearch<T>(T[] array, int index, int length, T value) Осуществляет поиск значения value в части массива array. Поиск начинается с индекса, задаваемого параметром index, и охватывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static int BinarySearch(Array array, int index, int length, object value, IComparer comparer) Осуществляет поиск значения value в части массива array, используя способ сравнения, определяемый параметром comparer. Поиск начинается с индекса, задаваемого параметром index, и охватывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static int BinarySearch<T>(T [] array, int index, int length, T value, Icomparer<T> comparer) Осуществляет поиск значения value в части массива array, используя способ сравнения, определяемый параметром comparer. Поиск начинается с индекса, задаваемого параметром index, и охватывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным public static void Clear(Array array, int index, int length) Устанавливает заданные элементы массива array равными нулю, пустому значению null или логическому значению false в зависимости от типа элемента: значения, ссылочного или логического. Подмножество элементов, подлежащих обнулению, начинается с индекса, задаваемого параметром index, и включает в себя число элементов, определяемых параметром length public object Clone() Возвращает копию вызывающего массива. Эта копия ссылается на те же элементы, что и оригинал, поэтому она называется “неполной". Таким образом, изменения, вносимые в элементы, влияют на оба массива, поскольку и в том и в другом используются одни и те же элементы public static void ConstrainedCopy(Array sourceArray, int sourceIndex, Array destinationArray, int destinationIndex, int length) Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray, начиная с элемента, указываемого по индексу sourceIndex, в целевой массив destinationArray, начиная с элемента, указываемого по индексу destinationIndex. Если оба массива имеют одинаковый ссылочный тип, то метод ConstrainedCopy() создает “неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray остается прежним public static ТТо[] ConvertAll<TInput, ТТо>(TFrom[] array, Converter<TOutput, TTo> converter) Преобразует массив array из типа TInput в тип TOutput и возвращает получающийся в итоге массив. Исходный массив остается прежним. Преобразование выполняется преобразователем, задаваемым параметром converter public static void Copy(Array sourceArray, Array destinationArray, int length) Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray в целевой массив destinationArray, начиная с первого элемента массива. Если оба массива имеют одинаковый ссылочный тип, то метод Сору() создает "неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным public static void Copy(Array sourceArray, Array destinationArray, long length) Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray в целевой массив destinationArray, начиная с первого элемента массива. Если оба массива имеют одинаковый ссылочный тип, то метод Сору() создает "неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным public static void Copy(Array sourceArray, int sourceIndex, Array destinationArray, int destinationlndex, int length) Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray, начиная с элемента, указываемого по индексу sourceArray[sourceIndex], в целевой массив destinationArray, начиная с элемента, указываемого по индексу destinationArray[destinationIndex]. Если оба массива имеют одинаковый ссылочный тип, то метод Сору() создает “неполную копию", в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным public static void Copy(Array sourceArray, long sourceIndex, Array destinationArray, long destinationIndex, long length) Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray, начиная с элемента, указываемого по индексу sourceArray[sourceIndex], в целевой массив destinationArray, начиная с элемента, указываемого по индексу destinationArray[destinationIndex]. Если оба массива имеют одинаковый ссылочный тип, то метод Сору() создает "неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным public void CopyTo(Array array, int index) Копирует элементы вызывающего массива в целевой массив array, начиная с элемента, указываемого по индексу array[index]. Если же во время копирования возникает ошибка, то содержимое целевого массива array оказывается неопределенным public void CopyTo(Array array, long index) Копирует элементы вызывающего массива в целевой массив array, начиная с элемента, указываемого по индексу array[index]. Если же во время копирования возникает ошибка, то содержимое целевого массива array оказывается неопределенным public static Array CreateInstance(Type elementType, int length) Возвращает ссылку на одномерный массив, который содержит число элементов типа elementType, определяемое параметром length public static Array Createlnstance(Type elementType, int length1, int length2) Возвращает ссылку на двумерный массив размером length1×length2. Каждый элемент этого массива имеет тип elementType public static Array Createlnstance(Type elementType, int length1, int length2, int length3) Возвращает ссылку на трехмерный массив размером length1×length2×length3. Каждый элемент этого массива имеет тип elementType public static Array Createlnstance(Type elementType, params int[] lengths) Возвращает ссылку на многомерный массив, размерность которого задается в массиве lengths. Каждый элемент этого массива имеет тип elementType public static Array Createlnstance(Type elementType, params long[] lengths) Возвращает ссылку на многомерный массив, размерность которого задается в массиве lengths. Каждый элемент этого массива имеет тип elementType public static Array Createlnstance(Type elementType, int[]lengths, int[] lowerBounds) Возвращает ссылку на многомерный массив, размерность которого задается в массиве lengths. Каждый элемент этого массива имеет тип elementType. Начальный индекс каждого измерения задается в массиве lowerBounds. Таким образом, этот метод позволяет создавать массивы, которые начинаются с некоторого индекса, отличного от нуля public static bool Exists<T>(T[] array, Predicate<T> match) Возвращает логическое значение true, если массив array содержит хотя бы один элемент, удовлетворяющий условию предиката, задаваемого параметром match, а иначе возвращает логическое значение false public static T Find<T>(T[] array, Predicate<T> match) Возвращает первый элемент массива array, удовлетворяющий условию предиката, задаваемого параметром match, а иначе возвращает значение типа default(Т) public static T[] FindAll<T>(T[] array, Predicate<T> match) Возвращает все элементы массива array, удовлетворяющие условию предиката, задаваемого параметром match, а иначе возвращает массив нулевой длины public static int FindIndex<T>(T[] array, Predicate<T> match) Возвращает индекс первого элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match, иначе возвращает значение -1 public static int FindIndex<T>(T[]array, int startIndex, Predicate<T> match) Возвращает индекс первого элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match. Поиск начинается с элемента, указываемого по индексу array[startIndex]. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1 public static int FindIndex<T>(T[] array, int startlndex, int count, Predicate<T> match) Возвращает индекс первого элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match. Поиск начинается с элемента, указываемого по индексу array[startIndex], и продолжается среди числа элементов, определяемых параметром count. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1 public static T FindLast<T>(T[] array, Predicate<T> match) Возвращает последний элемент массива array, удовлетворяющий условию предиката, задаваемого параметром match, иначе возвращает значение типа default(Т) public static int FindLastIndex<T>(Т[] array, Predicate<T> match) Возвращает индекс последнего элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match, иначе возвращает значение -1 public static int FindLastIndex<T>(T[] array, int startIndex, Predicate<T> match) Возвращает индекс последнего элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match. Поиск начинается в обратном порядке с элемента, указываемого по индексу array[startIndex], и оканчивается на элементе array[0]. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1 public static int FindLastIndex<T>(T[] array, int startIndex, int count, Predicate<T> match) Возвращает индекс последнего элемента массива array, удовлетворяющего условию предиката, задаваемого параметром v. Поиск начинается в обратном порядке с элемента, указываемого по индексу array[start], и продолжается среди числа элементов, определяемых параметром count. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1 public static void ForEach<T>(T[]array, Action<T> action) Применяет метод, задаваемый параметром action, к каждому элементу массива array public IEnumerator GetEnumerator() Возвращает перечислительный объект для массива. Перечислители позволяют опрашивать массив в цикле. Боле подробно перечислители описываются в главе 25 public override int GetHashCode() Возвращает хеш-код для вызывающего объекта public int GetLength(int dimension) Возвращает длину заданного измерения массива. Отсчет измерений начинается с нуля, поэтому для получения длины первого измерения необходимо передать данному методу значение 0 параметра dimension, для получения длины второго измерения — значение 1 и т.д. public long GetLongLength(int dimension) Возвращает длину заданного измерения массива в виде значения типа long. Отсчет измерений начинается с нуля, поэтому для получения длины первого измерения необходимо передать данному методу значение 0 параметра dimension, для получения длины второго измерения — значение 1 и т.д. public int GetLowerBound(int dimension) Возвращает начальный индекс заданного измерения массива, который обычно равен нулю. Параметр dimension определяет отсчет измерений с нуля, поэтому для получения начального индекса первого измерения необходимо передать данному методу значение 0 параметра dimension, для получения начального индекса второго измерения — значение 1 и т.д. public int GetUpperBound(int dimension) Возвращает конечный индекс заданного измерения массива. Параметр dimension определяет отсчет измерений с нуля, поэтому для получения конечного индекса первого измерения необходимо передать данному методу значение 0 параметра dimension, для получения конечного индекса второго измерения — значение 1 и т.д. public object GetValue(int index) Возвращает значение элемента из вызывающего массива по индексу index. Массив должен быть одномерным public object GetValue(long index) Возвращает значение элемента из вызывающего массива по индексу index. Массив должен быть одномерным public object GetValue(int index1, int index2) Возвращает значение элемента из вызывающего массива по индексам [index1, index2]. Массив должен быть двумерным public object GetValue(long index1, long index2) Возвращает значение элемента из вызывающего массива по индексам [index1, index2]. Массив должен быть двумерным public object GetValue(int index1, int index2, int index3) Возвращает значение элемента из вызывающего массива по индексам [index1, index2, index3]. Массив должен быть трехмерным public object GetValue(long index1, long index2, long idx3) Возвращает значение элемента из вызывающего массива по и