Int Compare(object х, object у)
Этот метод возвращает значение больше нуля, если х больше у; значение меньше нуля, если х меньше у; и, наконец, нулевое значение, если оба значения равны.
Интерфейс IComparer<T> находится в пространстве имен System. Collections . Generic. В нем определяется метод Compare (), общая форма которого приведена ниже.
Int Compare(Т х, Т у)
Он действует таким же образом, как и его необобщенный аналог, возвращая значение больше нуля, если х больше у значение меньше нуля, если х меньше у и, наконец, нулевое значение, если оба значения равны. Преимущество интерфейса IComparer<T> заключается в том, что он обеспечивает типовую безопасность. Ведь в этом случае тип обрабатываемых данных указывается явным образрм, а следовательно, никакого приведения типов не требуется.
В последующих разделах демонстрируется ряд наиболее распространенных операций с массивами.
Таблица 21.11. Свойства, определенные в классе Array
Свойство
Назначение
public bool IsFixedSize { get; }
public bool IsReadOnly { get; }
public bool
IsSynchronized { get; }
Доступно только для чтения. Принимает логическое значение true, если массив имеет фиксированный размер, и логическое значение false, если массив может изменять его динамически
Доступно только для чтения. Принимает логическое значение true, если объект класса Array предназначен только для чтения, а иначе — логическое значение false. Для массивов это свойство всегда имеет логическое значение true Доступно только для чтения. Принимает логическое значение true, если массив можно безопасно использовать в многопоточной среде, а иначе — логическое значение false. Для массивов это свойство всегда имеет логическое значение true
Свойство
Назначение '
public int Length {
Доступно только для чтения. Имеет тип int и содержит ко
get; }
личество элементов в массиве
Public long LongLength
Доступно только для чтения. Имеет тип long и содержит
{ get; }
количество элементов в массиве
public int Rank { get; }
Доступно только для чтения. Содержит размерность массива
Public object SyncRoot
Доступно только для чтения. Содержит объект, предназна
{ get; }
ченный для синхронизации доступа к массиву
Таблица 21.12. Методы, определенные в классе Array
Метод
Назначение
Public static
Возвращает доступную только для чтения коллек
ReadOnlyCollection<T>
цию, которая включает в себя массив, определяе
AsReadOnly<T>(Т [] array)
мый параметром array
Public static int
Осуществляет поиск значения value в массиве
BinarySearch(Array
array,
array. Возвращает индекс первого вхождения
object value)
искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
Public static int
Осуществляет поиск значения value в массиве
BinarySearch<T>(T[]
array,
array. Возвращает индекс первого вхождения
T value)
искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
Public static int
Осуществляет поиск значения value в масси
BinarySearch(Array
array,
ве, определяемом параметром array , исполь
object value, IComparer
зуя способ сравнения, задаваемый параметром
comparer)
comparer. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
Public static int
Осуществляет поиск значения value в массиве
BinarySearch<T> (T [ ]
array,
array , используя способ сравнения, задаваемый
T value, IComparer<T>
параметром comparer. Возвращает индекс перво
comparer)
го вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
Public static int
Осуществляет поиск значения value в части мас
BinarySearch(Array
array,
сива array. Поиск начинается с индекса, зада
int index, int length,
ваемого параметром index , и охватывает число
object value)
элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
Метод
Назначение
public static int
Осуществляет поиск значения value в части мас
BinarySearch<T>(T[] array,
сива array. Поиск начинается с индекса, зада
int index, int length, T
ваемого параметром index , и охватывает число
value)
элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static int
Осуществляет поиск значения value в части мас
BinarySearch(Array array,
сива array , используя способ сравнения, опреде
int index, int length,
ляемый параметром comparer. Поиск начинается
object value, IComparer
с индекса, задаваемого параметром index, и охва
comparer)
тывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static int
Осуществляет поиск значения value в части мас
BinarySearch<T>(T [] array,
сива array , используя способ сравнения, опреде
int index, int length,
ляемый параметром comparer. Поиск начинается
T value, Icomparer<T>
с индекса, задаваемого параметром index , и охва
comparer)
тывает число элементов, определяемых параметром length. Возвращает индекс первого вхождения искомого значения. Если оно не найдено, возвращает отрицательное значение. Массив array должен быть отсортированным и одномерным
public static void
Устанавливает заданные элементы массива array
Clear(Array array, int
равными нулю, пустому значению null или логи
index, int length)
ческому значению false в зависимости оттипэ элемента: значения, ссылочного или логического. Подмножество элементов, подлежащих обнулению, начинается с индекса, задаваемого параметром index , и включает в себя число элементов, определяемых параметром length
public object Clone ()
Возвращает копию вызывающего массива. Эта копия ссылается на те же элементы, что и оригинал, поэтому она называется “неполной". Таким образом, изменения, вносимые в элементы, влияют на оба массива, поскольку и в том и в другом используются одни и те же элементы
public static void
Копирует число элементов, задаваемых па
ConstrainedCopy(Array
раметром length, из исходного массива
sourceArray, int sourcelndex,
sourceArray, начиная с элемента, указывае
Array destinationArray, int
мого по индексу sourcelndex, в целевой мас
destinationlndex, int length)
сив destinationArray, начиная с элемента,
_ Продолжение табл. 21.12
Метод
Назначение
указываемого по индексу destinationlndex. Если
оба массива имеют одинаковый ссылочный тип, то метод ConstrainedCopy () создает “неполную копию", в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationAr ray остается прежним
public static TTo [ ]
Преобразует массив array из типа Tlnput в тип
ConvertА11<ТInput,
TOutput и возвращает получающийся в итоге
TTo>(TFrom[] array,
массив. Исходный массив остается прежним. Пре
Converter<TOutput, TTo>
образование выполняется преобразователем, за
converter)
даваемым параметром converter
public static void
Копирует число элементов, задаваемых параметром
Copy(Array sourceArray,
length, из исходного массива sourceArray в це
Array destinationArray,
int
левой массив destinationArray , начиная с пер
length)
вого элемента массива. Если оба массива имеют одинаковый ссылочный тип, то метод Сору () создает “неполную копию", в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным
public static void
Копирует число элементов, задаваемых параметром
Copy(Array sourceArray ,
length , из исходного массива sourceArray в це
Array destinationArray ,
long
левой массив destinationArray , начиная с пер
length)
вого элемента массива. Если оба массива имеют одинаковый ссылочный тип, то метод Сору () создает “неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным
public static void
Копирует число элементов, задаваемых параме
Copy(Array sourceArray ,
тром length , из исходного массива sourceArray ,
int sourcelndex, Array
начиная с элемента, указываемого по индексу
destinationArray ,int
sourceArray [ sourcelndex] , в целевой массив
destinationlndex, int
destinationArray , начиная с элемента, указы
length)
ваемого по индексу destinationAr ray [destinationlndex] .Если оба массива имеют одинаковый ссылочный тип, то метод Сору () создает “неполную копию”, в результате чего оба массива будут ссылаться на одни и те же элементы. Если же во время копирования возникает ошибка, то содержимое целевого массива destinationArray оказывается неопределенным
Метод
Назначение
public static void
Копирует число элементов, задаваемых параме
Copy(Array sourceArray ,
тром length, из исходного массива sourceArray,
long sourcelndex, Array
начиная с элемента, указываемого по индексу
destinationArray ,long
sourceArray [source Index] ,в целевой массив
destinationlndex, long
destinationArray, начиная с элемента, указы
length)
ваемого по индексу 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,
elementType, int length)
определяемое параметром length
public static Array
Возвращает ссылку на двумерный массив разме
Createlnstance(Type
ром lengthl*length2. Каждый элемент этого
elementType, int lengthl,
массива имеет тип elementType
int length2)
public static Array
^ Возвращает ссылку на трехмерный массив разме
Createlnstance(Type
ром lengthl* length2* length3. Каждый эле
elementType, int lengthl,
мент этого массива имеет тип elementType
int length2, int length3)
public static Array
Возвращает ссылку на многомерный массив, раз
Createlnstance(Type
мерность которого задается в массиве lengths.
elementType, params int[]
Каждый элемент этого массива имеет тип
lengths)
elementType
public static Array
Возвращает ссылку на многомерный массив, раз
Createlnstance(Type
мерность которого задается в массиве lengths.
elementType, params long[]
Каждый элемент этого массива имеет тип
lengths)
elementType
_ Продолжение табл. 21.12
Метод
Назначение
Public static Array
Возвращает ссылку на многомерный массив, раз
Createlnstance(Type
мерность которого задается в массиве lengths.
elementType, int []lengths,
Каждый элемент этого массива имеет тип
int[] lowerBounds)
elementType. Начальный индекс каждого измерения задается в массиве lowerBounds. Таким образом, этот метод позволяет создавать массивы, которые начинаются с некоторого индекса, отличного от нуля
Public static bool
Возвращает логическое значение true, если мас
Exists<T>(T[] array,
сив array содержит хотя бы один элемент, удо
Predicate<T> match)
влетворяющий условию предиката, задаваемого параметром match , а иначе возвращает логическое значение false
public static T Find<T>(T[]
Возвращает первый элемент массива array , удо
array , Predicate<T> match)
влетворяющий условию предиката, задаваемого параметром’ match, а иначе возвращает значение типа default (Т)
public static T[]
Возвращает все элементы массива array, удо
FindAll<T>(T[] array,
влетворяющие условию предиката, задаваемого
Predicate<T> match)
параметром match, а иначе возвращает массив нулевой длины
Public static int
Возвращает индекс первого элемента массива
FindIndex<T>(T[] array,
array, удовлетворяющего условию предиката, за
Predicate<T> match)
даваемого параметром match, иначе возвращает значение -1
Public static int
Возвращает индекс первого элемента масси
FindIndex<T>(T[] array, int
ва array, удовлетворяющего убловию предика
startlndex, Predicate<T>
та, задаваемого параметром match. Поиск на
match)
чинается с элемента, указываемого по индексу array [ start Index] .Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
Public static int
Возвращает индекс первого элемента масси
FindIndex<T>(T[] array,
ва array, удовлетворяющего условию предика
int startlndex, int count,
та, задаваемого параметром match. Поиск на
Predicate<T> match)
чинается с элемента, указываемого по индексу array [startlndex] ,и продолжается среди числа элементов, определяемых параметром count. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
Public static T
Возвращает последний элемент массива array,
FindLast<T>(T[] array,
удовлетворяющий условию предиката, задаваемо
Predicate<T> match)
го параметром match, иначе возвращает значение типа default (Т)
Метод
Назначение
Public static int
Возвращает индекс последнего элемента массива
FindLastIndex<T>(T []
array,
array, удовлетворяющего условию предиката, за
. Predicate<T> match )
даваемого параметром match, иначе возвращает значение -1
Public static int
Возвращает индекс последнего элемента массива
FindLastIndex<T>(T []
array,
array , удовлетворяющего условию предиката, за
int startlndex, Predicate<T>
даваемого параметром match. Поиск начинается
match)
в обратном порядке с элемента, указываемого по индексу array [startlndex] , и оканчивается на элементе array [ 0].Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
Public static int
Возвращает индекс последнего элемента массива
FindLastIndex<T>(T []
array,
array , удовлетворяющего условию предиката, за
int startlndex , int
count,
даваемого параметром v.Поиск начинается в об
Predicate<T> match)
ратном порядке с элемента, указываемого по индексу array[start] , и продолжается среди числа элементов, определяемых параметром count. Если ни один из элементов, удовлетворяющих данному условию, не найден, то возвращается значение -1
Public static void
Применяет метод, задаваемый параметром
ForEach<T>(T[] array,
action , к каждому элементу массива array
Action<T> action)
Public IEnumerator
Возвращает перечислительный объект для масси
GetEnumerator ()
ва. Перечислители позволяют опрашивать массив в цикле. Боле подробно перечислители описываются в главе 25
Public override int
Возвращает хеш-код для вызывающего объекта
GetHashCode ()
Public int GetLength(int
Возвращает длину заданного измерения массива.
dimension)
Отсчет измерений начинается с нуля, поэтому для получения длины первого измерения необходимо передать данному методу значение 0 параметра dimension , для получения длины второго измерения — значение 1 и т.д.