Таблица 21.12. Методы, определенные в классе Array
Метод
Назначение
public static ReadOnlyCollection AsReadOnly(T[] array)
Возвращает доступную только для чтения коллекцию, которая включает в себя массив, определяемый параметром array
public static int BinarySearch(Array array, object value)
Осуществляет поиск значения value в массиве array. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static int BinarySearch(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[] array, T value, IComparer 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[] 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 [] array, int index, int length, T value, Icomparer 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(TFrom[] array, Converter 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)
Возвращает ссылку на двумерный массив размером length1xlength2. Каждый элемент этого массива имеет тип elementType
public static Array Createlnstance(Type elementType, int length1, int length2, int length3)
Возвращает ссылку на трехмерный массив размером length1xlength2xlength3. Каждый элемент этого массива имеет тип 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[] array, Predicate match)
Возвращает логическое значение true, если массив array содержит хотя бы один элемент, удовлетворяющий условию предиката, задаваемого параметром match, а иначе возвращает логическое значение false
public static T Find(T[] array, Predicate match)
Возвращает первый элемент массива array, удовлетворяющий условию предиката, задаваемого параметром match, а иначе возвращает значение типа default(Т)
public static T[] FindAll(T[] array, Predicate match)
Возвращает все элементы массива array, удовлетворяющие условию предиката, задаваемого параметром match, а иначе возвращает массив нулевой длины
public static int FindIndex(T[] array, Predicate match)
Возвращает индекс первого элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match, иначе возвращает значение -1
public static int FindIndex(T[]array, int startIndex, Predicate match)
Возвращает индекс первого элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match. Поиск начинается с элемента, указываемого по индексу array[startIndex]. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
public static int FindIndex(T[] array, int startlndex, int count, Predicate match)
Возвращает индекс первого элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match. Поиск начинается с элемента, указываемого по индексу array[startIndex], и продолжается среди числа элементов, определяемых параметром count. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
public static T FindLast(T[] array, Predicate match)
Возвращает последний элемент массива array, удовлетворяющий условию предиката, задаваемого параметром match, иначе возвращает значение типа default(Т)
public static int FindLastIndex(Т[] array, Predicate match)
Возвращает индекс последнего элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match, иначе возвращает значение -1
public static int FindLastIndex(T[] array, int startIndex, Predicate match)
Возвращает индекс последнего элемента массива array, удовлетворяющего условию предиката, задаваемого параметром match. Поиск начинается в обратном порядке с элемента, указываемого по индексу array[startIndex], и оканчивается на элементе array[0]. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
public static int FindLastIndex(T[] array, int startIndex, int count, Predicate match)
Возвращает индекс последнего элемента массива array, удовлетворяющего условию предиката, задаваемого параметром v. Поиск начинается в обратном порядке с элемента, указываемого по индексу array[start], и продолжается среди числа элементов, определяемых параметром count. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
public static void ForEach(T[]array, Action 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)
Возвращает значение элемента из вызывающего массива по индексам [index1, index2, index3]. Массив должен быть трехмерным
public object GetValue(int[] indices)
Возвращает значение элемента из вызывающего массива по указанным индексам. Число измерений массива должно соответствовать числу элементов массива indices
public object GetValue(long[] indices)
Возвращает значение элемента из вызывающего массива по указанным индексам. Число измерений массива должно соответствовать числу элементов массива inices
public static int IndexOf(Array array, object value)
Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Если искомое значение не найдено, то возвращает -1. (Если же массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int IndexOf(T[] array, T value)
Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Если искомое значение не найдено, то возвращает -1
public static int IndexOf(Array array, object value, int startIndex)
Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Поиск начинается с элемента, указываемого по индексу array[startIndex]. Метод возвращает -1, если искомое значение не найдено. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int IndexOf(T[] array, T value, int startIndex)
Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Поиск начинается с элемента, указываемого по индексу array[startIndex]. Метод возвращает -1, если искомое значение не найдено
public static int IndexOf(Array array, object value, int startIndex, int count)
Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Поиск начинается с элемента, указываемого по индексу array[startIndex], и продолжается среди числа элементов, определяемых параметром count. Метод возвращает -1, если искомое значение не найдено в заданных пределах. (Если же массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int IndexOf(T[] array, T value, int startIndex, int count)
Возвращает индекс первого элемента, имеющего значение value в одномерном массиве array. Поиск начинается с элемента, указываемого по индексу array[startIndex], и продолжается среди числа элементов, определяемых параметром count. Метод возвращает -1, если искомое значение не найдено в заданных пределах public void Initialize Инициализирует каждый элемент вызывающего массива с помощью конструктора, используемого по умолчанию для соответствующего элемента. Этот метод можно использовать только для масси вов простых типов значений
public static int LastlndexOf(Array array, object value)
Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Если искомое значение не найдено, то возвращает -1. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int LastIndexOf(T[] array, T value)
Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Если искомое значение не найдено, то возвращает -1
public static int LastlndexOf(Array array, object value, int startIndex)
Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Поиск начинается в обратном порядке с элемента, указываемого по индексу array[startIndex], и оканчивается на элементе а[0]. Метод возвращает -1, если искомое значение не найдено. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int LastIndexOf(T[] array, T value, int startIndex)
Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Поиск начинается в обратном порядке с элемента, указываемого по индексу а[startIndex], и оканчивается на элементе а[0]. Метод возвращает -1, если искомое значение не найдено
public static int LastIndexOf(Array array, object value, int startIndex, int count)
Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Поиск начинается в обратном порядке с элемента, указываемого по индексу array[startIndex], и продолжается среди числа элементов, определяемых параметром count. Метод возвращает -1, если искомое значение не найдено в заданных пределах. (Если массив имеет ненулевую нижнюю границу, то неудачный исход поиска будет обозначаться значением нижней границы, уменьшенным на 1.)
public static int LastIndexOf(T[]array, T value, int startIndex, int count)
Возвращает индекс последнего элемента, имеющего значение value в одномерном массиве array. Поиск начинается в обратном порядке с элемента, указываемого по индексу array[startIndex], и продолжается среди числа элементов, определяемых параметром count. Метод возвращает -1, если искомое значение не найдено в заданных пределах
public static void Resize(ref T[] array, int newSize)
Задает длину newSize массива array
public static void Reverse(Array array)
Меняет на обратный порядок следования элементов в массиве array
public static void Reverse(Array array, int index, int length)
Меняет на обратный порядок следования элементов массива array заданных в пределах, начиная с элемента, указываемого по индексу array[index], и включая число элементов, определяемых параметром length
public void SetValue(object value, int index)
Устанавливает значение value элемента вызывающего массива по индексу index. Массив должен быть одномерным
public void SetValue(object value, long index)
Устанавливает значение value элемента вызывающего массива по индексу index. Массив должен быть одномерным
public void SetValue(object value, int index1, int index2)
Устанавливает значение value элемента вызывающего массива по индексам [index1, index2]. Массив должен быть двумерным
public void SetValue(object value, long index1, long index2)
Устанавливает значение value элемента вызывающего массива по индексам [index1, index2]. Массив должен быть двумерным
public void SetValue(object value, int index1, int index2, int index3)
Устанавливает значение 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(Array array)
Сортирует массив array по нарастающей. Массив должен быть одномерным
public static void Sort(T[]array)
Сортирует массив array по нарастающей. Массив должен быть одномерным
public static void Sort(Array array, IComparer comparer)
Сортирует массив array по нарастающей, используя способ сравнения, задаваемый параметром comparer. Массив должен быть одномерным
public static void Sort (T[] array, Comparison comparer)
Сортирует массив array по нарастающей, используя способ сравнения, задаваемый параметром comparer. Массив должен быть одномерным
public static void Sort (T[] array, IComparer comparer)
Сортирует массив array по нарастающей, используя способ сравнения, задаваемый параметром comparer. Массив должен быть одномерным
public static void Sort(Array keys, Array items)
Сортирует по нарастающей два заданных одномерных массива. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются по порядку нарастания ключей
public static void Sort(TKey[] keys, TV[] items)
Сортирует по нарастающей два заданных одномерных массива. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются по порядку возрастания ключей
public static void Sort(Array keys, Array items, Icomparer comparer)
Сортирует по нарастающей два заданных одномерных массива, используя способ сравнения, задаваемый параметром comparer. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются по порядку возрастания ключей
public static void Sort(TKey[] keys, TValue[] items, IComparer comparer)
Сортирует по нарастающей два заданных одномерных массива, используя способ сравнения, задаваемый параметром comparer. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются по порядку возрастания ключей
public static void Sort(Array array, int index, int length)
Сортирует массив array по нарастающей в заданных пределах, начиная с элемента, указываемого по индексу array[index], и включая число элементов, определяемых параметром length. Массив должен быть одномерным
public static void Sort(T[] array, int index, int length)
Сортирует массив array по нарастающей в заданных пределах, начиная с элемента, указываемого по индексу array[index], и включая число элементов, определяемых параметром length. Массив должен быть одномерным
public static void Sort(Array array, int index, int length, IComparer comparer)
Сортирует массив array по нарастающей в заданных пределах, начиная с элемента, указываемого по индексу array[index], и включая число элементов, определяемых параметром length, а также используя способ сравнения, задаваемый параметром v. Массив должен быть одномерным
public static void Sort(T[] array, int index, int length, Icomparer comparer)
Сортирует массив array по нарастающей в заданных пределах, начиная с элемента, указываемого по индексу array[index], и включая число элементов, определяемых параметром length, а также используя способ сравнения, задаваемый параметром comparer. Массив должен быть одномерным
public static void Sort(Array keys, Array Items, int index, int length)
Сортирует по нарастающей два одномерных массива в заданных пределах, начиная с элемента, указываемого по индексу index, и включая число элементов, определяемых параметром length. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются в заданных пределах по порядку возрастания ключей
public static void Sort(TKey[] keys, TValue[] items, int index, int length)
Сортирует по нарастающей два одномерных массива в заданных пределах, начиная с элемента, указываемого по индексу index, и включая число элементов, определяемых параметром length. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, оба массива должны содержать пары “ключ-значение”. После сортировки элементы обоих массивов располагаются в заданных пределах по порядку возрастания ключей
public static void Sort(Array keys, Array items, int index, int length, IComparer comparer)
Сортирует по нарастающей два одномерных массива в заданных пределах, начиная с элемента, указываемого по индексу index, и включая число элементов, определяемых параметром length, а также используя способ сравнения, задаваемый параметром comparer. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, эти два массива должны содержать пары “ключ-значение". После сортировки элементы обоих массивов располагаются в заданных пределах по порядку возрастания ключей
public static void Sort(TKey[] keys, TV items, int index, int length, Icomparer comparer)
Сортирует по нарастающей два одномерных массива в заданных пределах, начиная с элемента, указываемого по индексу index, и включая число элементов, определяемых параметром length, а также используя способ сравнения, задаваемый параметром comparer. Массив keys содержит ключи сортировки, а массив items — значения, связанные с этими ключами. Следовательно, эти два массива должны содержать пары.“ключ-значение”. После сортировки элементы обоих массивов располагаются в заданных пределах по порядку возрастания ключей
public static bool TrueForAll(Т[] array, Predicate match)
Возвращает логическое значение true, если все элементы массива array удовлетворяют условию предиката, задаваемого параметром match. Если один или более элементов этого массива не удовлетворяют заданному условию, то возвращается логическое значение false
Сортировка и поиск в массивах
