(https://msdn.microsoft.com/ru-ru/library/system.array)
Таблица 7.1. Основные свойства и методы класса System::Array
| Имя | Описание |
| Свойства | |
| Length LongLength | Получает целое число (соответственно Int32 или Int64), представляющее общее число элементов во всех измерениях массива. |
| Rank | Получает ранг (число измерений, Int32) массива. Например, одномерный массив возвращает 1, двухмерный массив возвращает 2 и т.д. |
| Методы | |
| BinarySearch(Ar,V); BinarySearch(Ar,i,L,V); | Выполняет поиск заданного значения (V) в диапазоне элементов (i – начальный индекс диапазона, L – длина диапазона) или во всем отсортированном одномерном массиве (Ar). Возвращает индекс элемента, содержащего искомое значение. |
| Clear(Ar,i,L); | Инициализирует заданный диапазон элементов (указанное число элементов – L, начиная с i-го) массива (Ar). При этом указанным элементам присваивается значение нуль, false или null(в зависимости от типа элемента). |
| ConvertAll<TIn,TOut> (Ar<TIn>^, Converter<Tin,TOut>^); | Преобразует массив одного типа в массив другого типа. |
| Copy(Ar1,Ar2,L); Copy(Ar1,i1,Ar2,i2,L); | Копирует диапазон элементов из одного массива (Ar1), начиная с первого (по умолчанию) или заданного (i1) элемента, и вставляет его в другой массив (Ar2), также начиная с первого (по умолчанию) или заданного (i2) элемента. Длина диапазона (L) и индексы задаются как целые числа (Int32 или Int64). |
| CopyTo(Ar,i); | Копирует все элементы текущего одномерного массива в другой заданный одномерный массив (Ar), начиная с указанного индекса (i) в массиве назначения. Индекс задается как целое число (Int32 или Int64). |
| CreateInstance(T,L); CreateInstance(T,L[]); | Создает одномерный или многомерный массив заданного типа (T) с заданными длинами (L) по измерениям и индексацией, начинающейся с нуля. Длины по измерениям задаются в массиве (Int32 или Int64). |
| GetEnumerator(); | Возвращает объект IEnumerator представления массива для перечисления его элементов. |
| GetLength(d); GetLongLength(d); | Получает целое число (соответственно Int32 или Int64), представляющее количество элементов в заданной размерности (d) массива. |
| GetLowerBound(d); | Получает нижнюю границу заданной размерности (d) массива. |
| GetType(); | Возвращает объект Type для текущего экземпляра. |
| GetUpperBound(d); | Получает верхнюю границу заданной размерности (d) массива. |
| GetValue(i); GetValue(i[]); | Получает значение(я), хранящиеся в указанной позиции (i) одномерного или многомерного массива. Индексы задаются как целое число или массив целых чисел (Int32 или Int64). |
| IndexOf(Ar,V); IndexOf(Ar,V,i); IndexOf(Ar,V,i,L); | Выполняет поиск заданного объекта (V) и возвращает индекс его первого вхождения внутри всего одномерного массива (Ar) или в заданном диапазоне его элементов (начиная с i-го и до последнего, либо указанное число элементов – L). |
| LastIndexOf(Ar,V); LastIndexOf(Ar,V,i); LastIndexOf(Ar,V,i,L); | Выполняет поиск заданного объекта (V) и возвращает индекс его последнего вхождения внутри всего одномерного массива (Ar) или в заданном диапазоне его элементов (начиная с 1-го и до i-го, либо указанное число элементов – L). |
| Resize(Ar,L); | Изменяет количество элементов в массиве (Ar) до указанной величины (L). Этот метод создает новый массив заданного размера, копирует элементы из старого массива в новый, а затем заменяет старый массив новым. |
| Reverse(Ar); Reverse(Ar,i,L); | Изменяет порядок следования элементов на обратный во всем одномерном массиве (Ar) или в заданном диапазоне его элементов (i – начальный индекс диапазона, L – длина диапазона). |
| SetValue(V,i); SetValue(V,i[]); | Присваивает значение (V) элементу, находящемуся в указанной позиции одномерного или многомерного массива. Индексы задаются как целое число или массив целых чисел (Int32 или Int64). |
| Sort(Ar); Sort(Ar,i1,i2); Sort(Ar1, Ar2); | Сортирует элементы во всем одномерном массиве (Ar) или в заданном диапазоне его элементов (i – начальный индекс диапазона, L – длина диапазона). Сортирует два одномерных массива по ключам в первом массиве. Один (Ar1) содержит ключи, а другой (Ar2) – соответствующие элементы. |
| ToString(); | Возвращает строку, которая представляет текущий объект. |
Получение свойств массивов
Пример 7.4. Использование свойств Length и Rank класса Array для определения и отображения длины массива и числа его размерностей.
#include "stdafx.h"
using namespace System;
int main(array<System::String^> ^args) {
array<int>^ Arr1 = { 1, 2, 3, 4, 5 };
array<int, 2>^ Arr2 = gcnew array<int, 2>(5, 10);
Console::WriteLine("Длина 1-го массива: {0} элементов.\n" +
"2-ой массив имеет {1} размерности.",
Arr1->Length, Arr2->Rank);
Console::ReadLine();
return 0;
}
/* Вывод:
Длина 1-го массива: 5 элементов.