Текст книги "C# 4.0: полное руководство"
Автор книги: Герберт Шилдт
Жанр:
Программирование
сообщить о нарушении
Текущая страница: 59 (всего у книги 83 страниц)
public override int GetHashCode() – Возвращает хеш-код для вызывающего объекта
public TypeCode GetTypeCode() – Возвращает значение перечисления TypeCode для структуры Boolean, т.е. TypeCode.Boolean
public static bool Parse(strings) – Возвращает эквивалент типа 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(strings,out boolresult) – Предпринимает попытку преобразовать символ из строки s в его эквивалентное значение типа bool. При успешной попытке это значение сохраняется в параметре result и возвращается логическое значение true. Если же строка s не содержит ни поле Boolean. TrueString, ни поле Boolean. FalseString, то возвращается логическое значение false, независимо от того, какими буквами набрано содержимое строки: прописными или строчными, в отличие от метода Parse(), который генерирует исключение в аналогичной ситуации
Класс Array
относится к числу наиболее часто используемых в пространстве имен System
. Он является базовым классом для всех массивов в С#. Следовательно, его методы можно применять к массивам любого встроенного в C# типа или же к массивам определяемого пользователем типа. Свойства, определенные в классе Array
, перечислены в табл. 21.11, а методы – в табл. 21.12.
В классе Array
реализуются следующие интерфейсы: ICloneable, ICollection, IEnumerable, IStructuralComparable, IStructuralEquatable
, а также IList
. Все интерфейсы, кроме ICloneable
, определены в пространстве имен System.Collections
, подробнее рассматриваемом в главе 25.
В ряде методов данного класса используется параметр типа IComparer
или IComparer
. Интерфейс 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
public static int BinarySearch(Array array, objectvalue) – Осуществляет поиск значения value в массиве array. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static int BinarySearch
public static int BinarySearch(Array array, objectvalue,IComparer comparer) – Осуществляет поиск значения value в массиве, определяемом параметром array, используя способ сравнения, задаваемый параметром comparer. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static int BinarySearch
public static int BinarySearch(Array array, intindex,intlength, objectvalue) – Осуществляет поиск значения value в части массива array. Поиск начинается с индекса, задаваемого параметром index, и охватывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static int BinarySearch
public static int BinarySearch(Array array, int index, int length, object value, IComparer comparer) – Осуществляет поиск значения value в части массива array, используя способ сравнения, определяемый параметром comparer. Поиск начинаетсяс индекса, задаваемого параметром index, и охватывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static int BinarySearch
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 sourcelndex, Array destinationArray, int destinationlndex, int length) – Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray, начиная с элемента, указываемого по индексу sourcelndex, в целевой массив destinationArray, начиная с элемента, указываемого по индексу destinationlndex. Если оба массива имеют одинаковый ссылочный тип, то метод ConstrainedCopy() создает “неполную копию", в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationAr ray остается прежним
public static TTo [ ] ConvertА11<ТInput, TTo>(TFrom[] array, 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 sourcelndex, Array destinationArray, int destinationlndex, int length) – Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray, начиная с элемента, указываемого по индексу sourceArray [ sourcelndex], в целевой массив destinationArray, начиная с элемента, указываемого по индексу destinationAr ray [destinationlndex] . Если оба массива имеют одинаковый ссылочный тип, то метод Сору() создает “неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным
public static void Copy(Array sourceArray, long sourcelndex, Array destinationArray, long destinationlndex, long length) – Копирует число элементов, задаваемых параметром length, из исходного массива sourceArray, начиная с элемента, указываемого по индексу sourceArray [source Index], в целевой массив destinationArray, начиная с элемента, указы ваемого по индексу destinationArray [destinationlndex] . Если оба массива имеют одинаковый ссылочный тип, то метод Сору() создает “неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива 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 Createlnstance(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
public static T Find
public static T[] FindAll
public static int FindIndex
public static int FindIndex
public static int FindIndex
public static T FindLast
public static int FindLastIndex
public static int FindLastIndex
public static int FindLastIndex
public static void ForEach
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,intindex2) – Возвращает значение элемента из вызывающего массива по индексам [index1, index2]. Массив должен быть двумерным
public object GetValue(long index1,longindex2) – Возвращает значение элемента из вызывающего массива по индексам [ index1, index2]. Массив должен быть двумерным
public object GetValue(int index1,intindex2,int index3) – Возвращает значение элемента из вызывающего массива по индексам [index1, index2, index3]. Массив должен быть трехмерным
public object GetValue(long index1,longindex2,long idx3) – Возвращает значение элемента из вызывающего массива по индексам [index1, index2, index3]. Массив должен быть трехмерным
public object GetValue(int[] indices) – Возвращает значение элемента из вызывающего массива по указанным индексам. Число измерений массива должно соответствовать числу элементов массива indices
public object GetValue(long[]indices) – Возвращает значение элемента из вызывающего массива по указанным индексам. Число измерений массива должно соответствовать числу элементов массива indices
public static int IndexOf(Arrayarray,object value) – Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Если искомое значение не найдено, то возвращает -1. (Если же массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int IndexOf
public static int IndexOf(Arrayarray, object value, intstartlndex) – Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Поиск начинается с элемента, указываемого по индексу array [startlndex]. Метод возвращает -1, если искомое значение не найдено. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int IndexOf
public static int IndexOf(Arrayarray, object value,intstartlndex,int count) – Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Поиск начинается с элемента, указываемого по индексу array [startlndex], и продолжается среди числа элементов, определяемых параметром count. Метод возвращает -1, если искомое значение не найдено в заданных пределах. (Если же массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int IndexOf
public void Initialize() – Инициализирует каждый элемент вызывающего массива с помощью конструктора, используемого по умолчанию для соответствующего элемента. Этот метод можно использовать только для массивов простых типов значений
public static int LastlndexOf(Arrayarray, objectvalue) – Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Если искомое значение не найдено, то возвращает -1. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int LastIndexOf-
public static int LastlndexOf(Arrayarray, objectvalue, intstartlndex) – Возвращает индекс последнего элемента, имеюще го значение value в одномерном массиве array. Поиск начинается в обратном порядке с элемента, указываемого по индексу array [startlndex], и оканчивается на элементе а [ 0]. Метод возвращает -1, если искомое значение не найдено. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int LastlndexOf
public static int LastlndexOf(Arrayarray, objectvalue,intstartlndex, intcount) – Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Поиск начинается в обратном порядке с элемента, указываемого по индексу array [start Index], и продолжается среди числа элементов, определяемых параметром count. Метод возвращает -1, если искомое значение не найдено в заданных пределах. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int LastlndexOf
public static void Resize
public static void Reverse(Arrayarray) – Меняет на обратный порядок следования элементов в массиве array
public static void Reverse(Arrayarray,int index,intlength) – Меняет на обратный порядок следования элементов массива array заданных в пределах, начиная с элемента, указываемого по индексу array [ index], и включая число элементов, определяемых параметром lenqth
public void SetValue(object value, intindex) – Устанавливает значение value элемента вызывающего массива по индексу index. Массив должен быть одномерным
public void SetValue(object value, longindex) – Устанавливает значение value элемента вызывающего массива по индексу index. Массив должен быть одномерным
public void SetValue(object value, intindex1,intindex2) – Устанавливает значение value элемента вызывающего массива по индексам [index1, index2]. Массив должен быть двумерным
public void SetValue(object value, longindex1,longindex2) – Устанавливает значение value элемента вызывающего массива по индексам [index1, index2]. Массив должен быть двумерным
public void SetValue(object value, intindex1,int index2, intindex3) – Устанавливает значение value элемента вызывающего массива по индексам [ index1, index2, index3]. Массив должен быть трехмерным
public void SetValue(object value, long index1, long index2, long index3) – Устанавливает значение value элемента вызывающего массива по индексам [ index1, index2, index3]. Массив должен быть трехмерным
public void SetValue(object value, int[]indices) – Устанавливает значение value элемента вызывающего массива по указанным индексам. Число измерений массива должно соответствовать числу элементов массива indices
public void SetValue(object value, long[]indices) – Устанавливает значение value элемента вызывающего массива по указанным индексам. Число измерений массива должно соответствовать числу элементов массива indices
public static void Sort(Arrayarray) – Сортирует массив array по нарастающей. Массив должен быть одномерным
public static void Sort
public static void Sort(Arrayarray,IComparer comparer) – Сортирует массив array по нарастающей, используя способ сравнения, задаваемый параметром comparer. Массив должен быть одномерным
public static void Sort
public static void Sort
public static void Sort(Arraykeys,Array iterns) – Сортирует по нарастающей два заданных одномерных массива. Массив keys содержит ключи сортировки, а массив items – значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются по порядку нарастания ключей
public static void Sort
public static void Sort(Arraykeys,Array items,Icomparercomparer) – Сортирует по нарастающей два заданных одномерных массива, используя способ сравнения, задаваемый параметром comparer. Массив keys содержит ключи сортировки, а массив i terns – значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются по порядку возрастания ключей
public static void Sort
public static void Sort(Arrayarray,intindex, intlength) – Сортирует массив array по нарастающей в заданных пределах, начиная с элемента, указываемого по индексу array [index], и включая число элементов, определяемых параметром length. Массив должен быть одномерным
public static void Sort
public static void Sort (Array array, intindex,intlength, IComparercomparer) – Сортирует массив array по нарастающей в заданных пределах, начиная с элемента, указываемого по индексу array [index], и включая число элементов, определяемых параметром length, а также используя способ сравнения, задаваемый параметром v. Массив должен быть одномерным
public static void Sort