Г. Шилдт - Полный справочник по C# (1160789), страница 99
Текст из файла (страница 99)
Еслионо не найдено, возвращает отрицательное число. Массив адолжен быть отсортированным и одномернымpublic static intBinarySearch(Array a,int start,int count,object v,IComparer comp)В части массива, заданного параметром а, выполняет поискзначения, заданного параметром v, с использованием методасравнения, заданного параметром сотр. Поиск начинается синдекса, заданного параметром start,и охватывает countэлементов.
Возвращает индекс первого вхождения искомогозначения. Если оно не найдено, возвращает отрицательное число. Массив а должен быть отсортированным и одномерным528Часть II. Библиотека С#Продолжение табл. 19.12МетодОписаниеpublic s t a t i c voidClear(Array a,int start,int count)Устанавливает заданные элементы равными нулю. Диапазонэлементов, подлежащих обнулению, начинается с индекса, заданного параметром s t a r t , и включает count элементовpublic virtual object Clone()Возвращает копию вызывающего массива. Эта копия ссылается на те же элементы, что и оригинал, за что получила название "поверхностной". Это означает, что изменения, вносимыев элементы, влияют на оба массива, поскольку они оба используют одни и те же элементыpublic static voidCopy(Array source,Array dest,int count)Копирует count элементов из массива source в массивdest.
Копирование начинается с начальных элементов каждого массива. Если оба массива имеют одинаковый ссылочныйтип, метод с о р у ( ) создает "поверхностную копию", в результате чего оба массива будут ссылаться на одни и те жеэлементыpublic static voidCopy(Array source,int srcStart,Array dest,int destStart,int count)Копирует count элементов из массива source (начиная сэлемента с индексом srcstart)в массив dest (начиная сэлемента с индексом deststart).Если оба массива имеютодинаковый ссылочный тип, метод Сору () создает"поверхностную копию", в результате чего оба массива будутссылаться на одни и те же элементыpublic virtual voidCopyTo(Array dest,int start)Копирует элементы вызывающего массива в массивначиная с элемента d e s t [ s t a r t ]public static ArrayCreatelnstance(Type t,int size)Возвращает ссылку на одномерный массив, который содержитsize элементов типа tpublic static ArrayCreatelnstance(Type t,int sizel,int size2)Возвращает ссылку на двумерный массив размеромsizel*size2.Каждый элемент этого массива имеет тип tpublic static ArrayCreatelnstance(Type t,int sizel,int size2,int size3)Возвращает ссылку на трехмерный массив размеромsizei*size2*size3.Каждый элемент этого массива имеет тип tpublic static ArrayCreatelnstance(Type t,int[] sizes)Возвращает ссылку на многомерный массив, размерности котоого заданы в массиве sizes.
Каждый элемент этого массива имеет тип tpublic static ArrayCreatelnstance(Type t,int[] sizes,int[] startlndexes)Возвращает ссылку на многомерный массив, размерности котоого заданы в массиве sizes. Каждый элемент этого массива имеет тип t . Начальный индекс каждой размерности задан в массиве s t a r t l n d e x e s . Таким образом, этот методпозволяет создавать массивы, которые начинаются с некоторого индекса, отличного от нуляpublic override boolEquals(object v)Возвращает значение t r u e , если значение вызывающегообъекта равно значению параметра vpublic virtual IEnumeratorGetEnumerator()Возвращает нумераторный объект для массива. Нумераторпозволяет опрашивать массив в цикле.
Нумераторы описаны вглаве 22, "Коллекции"Глава 19. Пространство имен Systemdest,529Продолжение табл. 19.12МетодОписаниеpublic int GetLength(int dim)Возвращает длину заданной размерности. Отсчет размерностей начинается с нуля; следовательно, для получения длиныпервой размерности необходимо передать методу значение О,а для получения длины второй — значение 1public intGetLowerBound(int dim)Возвращает начальный индекс заданной размерности, который обычно равен нулю. Параметр dim ориентирован на то,что отсчет размерностей начинается с нуля; следовательно,для получения начального индекса первой размерности необходимо передать методу значение 0, а для получения начального индекса второй — значение 1public override intGetHashCodeOВозвращает хеш-код для вызывающего объектаpublic TypeCode GetTypeCode()Возвращает значение перечисления TypeCode для классаA r r a y , Т.е.
TypeCode . A r r a ypublic intGetUpperBound(int dim)Возвращает конечный индекс заданной размерности, которыйобычно равен нулю. Параметр dim ориентирован на то, чтоотсчет размерностей начинается с нуля; следовательно, дляполучения конечного индекса первой размерности необходимопередать методу значение 0, а для получения конечного индекса второй — значение 1public object GetValue(int ldx)Возвращает значение элемента вызывающего массива с индексом idx. Массив должен быть одномернымpublic object GetValue(int idxl,int idx2)Возвращает значение элемента вызывающего массива с индексами [ idxl,idx2]. Массив должен быть двумернымpublic object GetValue(int idxl,int idx2,int idx3)Возвращает значение элемента вызывающего массива с индексами [ idxl,idx2,idx3].
Массив должен бытьтрехмернымpublic objectGetValue(int[] idxs)Возвращает значение элемента вызывающего массива с индексами, заданными с помощью параметра idxs. Вызывающий массив должен иметь столько размерностей, сколькоэлементов в массиве idxspublic static intIndexOf(Array a, object v)Возвращает индекс первого элемента одномерного массиваа, который имеет значение, заданное параметром v. Возвращает - 1 , если искомое значение не найдено. (Если массивимеет нижнюю границу, отличную от 0, признак неудачноговыполнения метода будет равен значению нижней границы,уменьшенному на 1)public static intIndexOf(Array a,object v,int start)Возвращает индекс первого элемента одномерного массиваа, который имеет значение, заданное параметром v.
Поискначинается с элемента a [start].Возвращает - 1 , если искомое значение не найдено. (Если массив имеет нижнюю границу, отличную от 0, признак неудачного выполнения методабудет равен значению нижней границы, уменьшенному на 1)public static intIndexOf(Array a,object v,int start,int count)Возвращает индекс первого элемента одномерного массиваа, который имеет значение, заданное параметром v. Поискначинается с элемента а [ s t a r t ] и охватываетсоилt элементов.
Метод возвращает - 1 , если внутри заданного диапазона искомое значение не найдено. (Если массив имеет нижнюю границу, отличную от 0, признак неудачного выполненияметода будет равен значению нижней границы, уменьшенномуна 1)530Часть II. Библиотека С#Продолжение табл. 19.12МетодОписаниеpublic void Initialize()Инициализирует каждый элемент вызывающего массива посредством вызова конструктора по умолчанию, соответствующего конкретному элементу.
Этот метод можно использоватьтолько для массивов нессылочных типовpublic static intLastlndexOf(Array a,object v)Возвращает индекс последнего элемента одномерного массива а, который имеет значение, заданное параметром v. Возвращает - 1 , если искомое значение не найдено. (Если массивимеет нижнюю границу, отличную от 0, признак неудачноговыполнения метода будет равен значению нижней границы,уменьшенному на 1)public static intLastlndexOf(Array a,object v,int start)Возвращает индекс последнего элемента заданного диапазонаодномерного массива а, который имеет значение, заданноепараметром v. Поиск осуществляется в обратном порядке, начиная с элемента а [ s t a r t ] и заканчивая элементом а [0].Метод возвращает число - 1 , если искомое значение не найдено. (Если массив имеет нижнюю границу, отличную от О,признак неудачного выполнения метода будет равен значениюнижней границы, уменьшенному на 1)public static intLastlndexOf(Array a,object v,int start,int count)Возвращает индекс последнего элемента заданного диапазонаодномерного массива а, который имеет значение, заданное параметром v.
Поиск осуществляется в обратном порядке, начинаяс элемента a [ s t a r t ] , и oxeaTbieaeTcount элементов. Методвозвращает - 1 , если внутри заданного диапазона искомое значение не найдено. (Если массив имеет нижнюю границу, отличную от 0, признак неудачного выполнения метода будет равензначению нижней границы, уменьшенному на 1)public static voidReverse(Array a)Меняет на обратный порядок следования элементов в массиве аpublic static voidReverse(Array a,int start,int count)Меняет на обратный порядок следования элементов в заданном диапазоне массива а. Упомянутый диапазон начинается сэлемента а [ start]и включает c o u n t элементовpublic void SetValue(object v,int idx)Устанавливает в вызывающем массиве элемент с индексомidx равным значению v. Массив должен быть одномернымpublic void SetValue(object v,int idxl,int idx2)Устанавливает в вызывающем массиве элемент с индексами[ idxl,idx2] равным значению v.
Массив должен бытьдвумернымpublic void SetValue(object v,int idxl,int idx2,int idx3)Устанавливает в вызывающем массиве элемент с индексами[ idxl,idx2,idx3] равным значению v. Массив должен быть трехмернымpublic void SetValue(object v,int[] idxs)Устанавливает в вызывающем массиве элемент с индексами,заданными параметром idxs, равным значению v. Вызывающий массив должен столько размерностей, сколько элементов в массиве idxspublic static void Sort(Array a)Сортирует массив а в порядке возрастания.