Сведения о массивах
Краткое описание
Описывает массивы, которые представляют собой структуры данных, предназначенные для хранения коллекций элементов.
Полное описание
Массив — это структура данных, предназначенная для хранения коллекции элементов. Элементы могут иметь один и тот же тип или разные типы.
Начиная с Windows PowerShell 3.0 коллекция из нуля или одного объекта имеет некоторые свойства массивов.
Создание и инициализация массива
Чтобы создать и инициализировать массив, назначьте переменной несколько значений. Значения, хранящиеся в массиве, разделяются запятой и отделяются от имени переменной оператором присваивания (=).
Например, чтобы создать массив с именем $A , содержащий семь числовых значений (int) 22, 5, 10, 8, 12, 9 и 80, введите следующее:
$A = 22,5,10,8,12,9,80
Запятая также может использоваться для инициализации одного массива элементов, поместив запятую перед отдельным элементом.
Например, чтобы создать один массив элементов с именем $B , содержащий одно значение 7, введите следующее:
$B = ,7
Вы также можете создать и инициализировать массив с помощью оператора диапазона (..).
В следующем примере создается массив, содержащий значения от 5 до 8.
$C = 5..8
В результате $C содержит четыре значения: 5, 6, 7 и 8.
Если тип данных не указан, PowerShell создает каждый массив как массив объектов (System.Object[]). Чтобы определить тип данных массива, используйте метод GetType(). Например, чтобы определить тип данных массива, введите $A :
$A.GetType()
Чтобы создать строго типизированный массив, то есть массив, который может содержать только значения определенного типа, приведите переменную к типу массива, например string[], long[] или int32[]. Чтобы привести массив, предваряйте имя переменной типом массива, заключенным в квадратные скобки. Например, чтобы создать 32-разрядный массив целых чисел с именем $ia , содержащий четыре целых числа (1500, 2230, 3350 и 4000), введите следующее:
[int32[]]$ia = 1500,2230,3350,4000
В результате $ia массив может содержать только целые числа.
В microsoft платформа .NET Framework можно создавать массивы, которые приведены к любому поддерживаемому типу. Например, объекты, извлекаемые Get-Process для представления процессов, относятся к типу System.Diagnostics.Process . Чтобы создать строго типизированный массив объектов процесса, введите следующую команду:
[Diagnostics.Process[]]$zz = Get-Process
Оператор вложенного выражения массива
Оператор вложенного выражения массива создает массив из инструкций внутри него. Независимо от того, что создает оператор внутри оператора, оператор поместит его в массив. Даже если объект равен нулю или одному.
Синтаксис оператора массива выглядит следующим образом:
@( ... )
Оператор массива можно использовать для создания массива с нулевым или одним объектом. Пример:
$a = @("Hello World")
$a.Count
1
$b = @()
$b.Count
0
Оператор массива полезен в скриптах при получении объектов, но не знает, сколько объектов вы получаете. Пример:
$p = @(Get-Process Notepad)
Дополнительные сведения об операторе вложенного выражения массива см. в разделе about_Operators.
Доступ к элементам массива и их использование
Чтение массива
Вы можете ссылаться на массив, используя его имя переменной. Чтобы отобразить все элементы в массиве, введите имя массива. Например, предположим, что $a является массивом, содержащим целые числа 0, 1, 2, до 9; введите:
$a
0
1
2
3
4
5
6
7
8
9
Вы можете ссылаться на элементы в массиве с помощью индекса, начиная с позиции 0. Заключите номер индекса в квадратные скобки. Например, чтобы отобразить первый элемент в массиве, введите $a :
$a[0]
0
Чтобы отобразить третий элемент в массиве, введите $a :
$a[2]
2
Часть массива можно получить с помощью оператора range для индекса. Например, чтобы получить второй-пятый элементы массива, введите:
$a[1..4]
1
2
3
4
Отрицательные числа отсчитываются от конца массива. Например, "-1" относится к последнему элементу массива. Чтобы отобразить последние три элемента массива, в порядке возрастания индекса введите:
$a = 0 .. 9
$a[-3..-1]
7
8
9
Если ввести отрицательные индексы в порядке убывания, выходные данные будут изменены.
$a = 0 .. 9
$a[-1..-3]
9
8
7
Однако будьте осторожны при использовании этой нотации. Нотация циклически от конечной границы до начала массива.
$a = 0 .. 9
$a[2..-2]
2
1
0
9
8
Кроме того, одной распространенной ошибкой является предположение, что $a[0..-2] ссылается на все элементы массива, за исключением последнего. Он ссылается на первый, последний и второй к последнему элементам в массиве.
Оператор "плюс" (+) можно использовать для объединения диапазонов со списком элементов в массиве. Например, чтобы отобразить элементы в позициях индекса от 0, 2 и 4 до 6, введите:
$a = 0 .. 9
$a[0,2+4..6]
0
2
4
5
6
Кроме того, для перечисления нескольких диапазонов и отдельных элементов можно использовать оператор "плюс". Например, чтобы вывести список элементов с нуля до двух, от четырех до шести и элемента в восьмом позициональном типе:
$a = 0..9
$a[+0..2+4..6+8]
0
1
2
4
5
6
8
Итерации по элементам массива
Вы также можете использовать конструкции циклов, такие как циклы ForEach, For и While, для ссылки на элементы в массиве. Например, чтобы использовать цикл ForEach для отображения элементов в массиве $a , введите:
$a = 0..9
foreach ($element in $a) {
$element
}
0
1
2
3
4
5
6
7
8
9
Цикл Foreach выполняет итерацию по массиву и возвращает каждое значение в массиве до достижения конца массива.
Цикл For полезен при приращении счетчиков при проверке элементов в массиве. Например, чтобы использовать цикл For для возврата всех остальных значений в массиве, введите следующее:
$a = 0..9
for ($i = 0; $i -le ($a.length - 1); $i += 2) {
$a[$i]
}
0
2
4
6
8
Вы можете использовать цикл While для отображения элементов в массиве до тех пор, пока определенное условие не будет выполняться. Например, чтобы отобразить элементы в массиве $a , если индекс массива меньше 4, введите:
$a = 0..9
$i=0
while($i -lt 4) {
$a[$i];
$i++
}
0
1
2
3
Свойства массивов
Count или Length или LongLength
Чтобы определить, сколько элементов находится в массиве Length , используйте свойство или его Count псевдоним. Longlength полезно, если массив содержит более 2 147 483 647 элементов.
$a = 0..9
$a.Count
$a.Length
10
10
Ранг
Возвращает число измерений в массиве. Большинство массивов в PowerShell имеют только одно измерение. Даже если вы думаете, что вы создаете многомерный массив; как в следующем примере:
$a = @(
@(0,1),
@("b", "c"),
@(Get-Process)
)
[int]$r = $a.Rank
"`$a rank: $r"
$a rank: 1
В следующем примере показано, как создать действительно многомерный массив с помощью платформы .NET Framework.
[int[,]]$rank2 = [int[,]]::new(5,5)
$rank2.rank
2
Методы массивов
Clear
Задает для всех значений элементов значение по умолчанию для типа элемента массива. Метод Clear() не сбрасывает размер массива.
В следующем примере $a представляет собой массив объектов .
$a = 1, 2, 3
$a.Clear()
$a | % { $null -eq $_ }
True
True
True
В этом примере явно типируется для $intA хранения целых чисел.
[int[]] $intA = 1, 2, 3
$intA.Clear()
$intA
0
0
0
ForEach
Позволяет выполнять итерацию по всем элементам в массиве и выполнять определенную операцию для каждого элемента массива.
Метод ForEach имеет несколько перегрузок, которые выполняют различные операции.
ForEach(scriptblock expression)
ForEach(scriptblock expression, object[] arguments)
ForEach(type convertToType)
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
ForEach(string methodName)
ForEach(string methodName, object[] arguments)
ForEach(scriptblock expression)
ForEach(scriptblock expression, object[] arguments)
Этот метод был добавлен в PowerShell версии 4.
Примечание
Синтаксис требует использования блока скрипта. Круглые скобки являются необязательными, если scriptblock является единственным параметром. Кроме того, между методом и открывающей скобкой или фигурной скобкой не должно быть пробела.
В следующем примере показано, как использовать метод foreach. В этом случае целью является создание квадратного значения элементов в массиве.
$a = @(0 .. 3)
$a.ForEach({ $_ * $_})
0
1
4
9
Как и -ArgumentList параметр , arguments параметр позволяет передавать массив аргументов в блок скриптаForEach-Object, настроенный для их принятия.
Дополнительные сведения о поведении ArgumentList см. в разделе about_Splatting.
ForEach(type convertToType)
Метод ForEach можно использовать для быстрого приведения элементов к другому типу. В следующем примере показано, как преобразовать список строковых дат в [DateTime] тип.
@("1/1/2017", "2/1/2017", "3/1/2017").ForEach([datetime])
Sunday, January 1, 2017 12:00:00 AM
Wednesday, February 1, 2017 12:00:00 AM
Wednesday, March 1, 2017 12:00:00 AM
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
Метод ForEach также можно использовать для быстрого получения или задания значений свойств для каждого элемента в коллекции.
# Set all LastAccessTime properties of files to the current date.
(dir 'C:\Temp').ForEach('LastAccessTime', (Get-Date))
# View the newly set LastAccessTime of all items, and find Unique entries.
(dir 'C:\Temp').ForEach('LastAccessTime') | Get-Unique
Wednesday, June 20, 2018 9:21:57 AM
ForEach(string methodName)
ForEach(string methodName, object[] arguments)
Наконец, ForEach методы можно использовать для выполнения метода для каждого элемента в коллекции.
("one", "two", "three").ForEach("ToUpper")
ONE
TWO
THREE
Как и -ArgumentList параметр , arguments параметр позволяет передавать массив аргументов в блок скриптаForEach-Object, настроенный для их принятия.
Примечание
Начиная с Windows PowerShell 3.0 получение свойств и выполнение методов для каждого элемента в коллекции также можно выполнить с помощью "Методы скалярных объектов и коллекций". Дополнительные сведения об этом см. здесь about_methods.
Where
Позволяет фильтровать или выбирать элементы массива. Скрипт должен иметь значение, отличное от: ноль (0), пустая строка $false или $null , чтобы элемент отображал после Where
Существует одно определение для Where метода .
Where(scriptblock expression[, WhereOperatorSelectionMode mode
[, int numberToReturn]])
Примечание
Синтаксис требует использования блока скрипта. Круглые скобки являются необязательными, если scriptblock является единственным параметром. Кроме того, между методом и открывающей скобкой или фигурной скобкой не должно быть пробела.
Аргумент Expression является scriptblock, который требуется для фильтрации, mode необязательный аргумент разрешает дополнительные возможности выбора, а numberToReturn необязательный аргумент позволяет ограничить количество элементов, возвращаемых фильтром.
Допустимые значения для mode :
- По умолчанию (0) — возврат всех элементов
- Первый (1) — возврат первого элемента
- Last (2) — возврат последнего элемента
- SkipUntil (3) — пропускать элементы до тех пор, пока условие не примет значение true, возврат оставшихся элементов
- Until (4) — возвращает все элементы до тех пор, пока условие не примет значение true.
- Разделение (5) — возвращает массив из двух элементов.
- Первый элемент содержит совпадающие элементы
- Второй элемент содержит оставшиеся элементы
В следующем примере показано, как выбрать все нечетные числа из массива.
(0..9).Where{ $_ % 2 }
1
3
5
7
9
В этом примере показано, как выбрать строки, которые не являются пустыми.
('hi', '', 'there').Where({$_.Length})
hi
there
Default
Режим Default фильтрует элементы с помощью Expression scriptblock.
numberToReturn Если указан , он указывает максимальное количество возвращаемых элементов.
# Get the zip files in the current users profile, sorted by LastAccessTime.
$Zips = dir $env:userprofile -Recurse '*.zip' | Sort-Object LastAccessTime
# Get the least accessed file over 100MB
$Zips.Where({$_.Length -gt 100MB}, 'Default', 1)
Примечание
Default Режим и First режим возвращают первые элементы (numberToReturn) и могут использоваться взаимозаменяемо.
Последний
$h = (Get-Date).AddHours(-1)
$logs = dir 'C:\' -Recurse '*.log' | Sort-Object CreationTime
# Find the last 5 log files created in the past hour.
$logs.Where({$_.CreationTime -gt $h}, 'Last', 5)
SkipUntil
Режим SkipUntil пропускает все объекты в коллекции, пока объект не пройдет фильтр выражения блока скрипта. Затем он возвращает ВСЕ оставшиеся элементы коллекции без тестирования. Тестируется только один проходящий элемент.
Это означает, что возвращаемая коллекция содержит как передающие , так и непередаваемые элементы, которые не были протестированы.
Количество возвращаемых элементов можно ограничить путем передачи значения аргументу numberToReturn .
$computers = "Server01", "Server02", "Server03", "localhost", "Server04"
# Find the first available online server.
$computers.Where({ Test-Connection $_ }, 'SkipUntil', 1)
localhost
До условия
Режим Until инвертирует SkipUntil режим . Он возвращает ВСЕ элементы в коллекции до тех пор, пока элемент не пройдет выражение блока скрипта. После того как элемент передает выражение scriptblock, метод прекращает обработку Where элементов.
Это означает, что вы получаете первый набор непередаваемых элементов из Where метода . После прохождения одного элемента остальные не проверяются и не возвращаются.
Количество возвращаемых элементов можно ограничить путем передачи значения аргументу numberToReturn .
# Retrieve the first set of numbers less than or equal to 10.
(1..50).Where({$_ -gt 10}, 'Until')
# This would perform the same operation.
(1..50).Where({$_ -le 10})
1
2
3
4
5
6
7
8
9
10
Примечание
Оба Until и SkipUntil работают в локальной среде НЕ тестировать пакет элементов.
Until возвращает элементы ДО первого прохода.
SkipUntil возвращает все элементы ПОСЛЕ первого прохода, включая первый проходящий элемент.
Разделение
Режим Split разделяет или группирует элементы коллекции на две отдельные коллекции. Те, которые передают выражение scriptblock, и те, которые не передают.
numberToReturn Если указан , первая коллекция содержит проходящие элементы, чтобы не превышать указанное значение.
Остальные объекты, даже те, которые передают фильтр выражений, возвращаются во второй коллекции.
$running, $stopped = (Get-Service).Where({$_.Status -eq 'Running'}, 'Split')
$running
Status Name DisplayName
------ ---- -----------
Running Appinfo Application Information
Running AudioEndpointBu... Windows Audio Endpoint Builder
Running Audiosrv Windows Audio
...
$stopped
Status Name DisplayName
------ ---- -----------
Stopped AJRouter AllJoyn Router Service
Stopped ALG Application Layer Gateway Service
Stopped AppIDSvc Application Identity
...
Получение элементов массива
Чтобы получить свойства и методы массива, такие как свойство Length и метод SetValue , используйте параметр InputObject командлета Get-Member .
При конвейере массива Get-Memberв PowerShell отправляет элементы по одному и Get-Member возвращает тип каждого элемента в массиве (игнорируя дубликаты).
При использовании параметра Get-MemberInputObject возвращает элементы массива.
Например, следующая команда получает члены переменной массива $a .
Get-Member -InputObject $a
Вы также можете получить элементы массива, введя запятую (,) перед значением, которое передается в Get-Member командлет. Запятая делает массив вторым элементом в массиве массивов. PowerShell передает массивы по одному и Get-Member возвращает элементы массива. Как и в следующих двух примерах.
,$a | Get-Member
,(1,2,3) | Get-Member
Управление массивом
Вы можете изменить элементы в массиве, добавить элемент в массив и объединить значения из двух массивов в третий массив.
Чтобы изменить значение определенного элемента в массиве, укажите имя массива и индекс элемента, который требуется изменить, а затем используйте оператор присваивания (=), чтобы указать новое значение для элемента. Например, чтобы изменить значение второго элемента в массиве $a (позиция индекса 1) на 10, введите:
$a[1] = 10
Для изменения значения можно также использовать метод SetValue массива. В следующем примере второе значение (позиция индекса 1) массива изменяется на $a 500:
$a.SetValue(500,1)
Оператор можно использовать для += добавления элемента в массив. В следующем примере показано, как добавить элемент в $a массив .
$a = @(0..4)
$a += 5
Примечание
При использовании += оператора PowerShell фактически создает новый массив со значениями исходного массива и добавленного значения. Это может привести к проблемам с производительностью, если операция повторяется несколько раз или размер массива слишком велик.
Удалить элементы из массива непросто, но можно создать новый массив, содержащий только выбранные элементы существующего массива. Например, чтобы создать $t массив со всеми элементами в массиве $a , кроме значения в позиции индекса 2, введите:
$t = $a[0,1 + 3..($a.length - 1)]
Чтобы объединить два массива в один массив, используйте оператор плюса (+). В следующем примере создаются два массива, объединяются, а затем отображается результирующий объединенный массив.
$x = 1,3
$y = 5,9
$z = $x + $y
В результате $z массив содержит 1, 3, 5 и 9.
Чтобы удалить массив, присвойте массиву значение $null . Следующая команда удаляет массив в переменной $a .
$a = $null
Можно также использовать Remove-Item командлет , но назначение значения $null выполняется быстрее, особенно для больших массивов.
Массивы, равные нулю или единице
Начиная с Windows PowerShell 3.0 коллекция, состоящая из нуля или одного объекта, имеет свойство Count и Length. Кроме того, можно индексировать в массиве одного объекта. Эта функция помогает избежать ошибок скриптов, возникающих, когда команда, которая ожидает коллекцию, получает менее двух элементов.
В следующих примерах показана эта функция.
Ноль объектов
$a = $null
$a.Count
$a.Length
0
0
Один объект
$a = 4
$a.Count
$a.Length
$a[0]
$a[-1]
1
1
4
4
Поддержка индексирования для объектов System.Tuple
В PowerShell 6.1 добавлена поддержка индексированного доступа к объектам Кортежа , аналогично массивам. Пример:
PS> $tuple = [Tuple]::Create(1, 'test')
PS> $tuple[0]
1
PS> $tuple[1]
test
PS> $tuple[0..1]
1
test
PS> $tuple[-1]
test
В отличие от массивов и других объектов коллекции, объекты Кортежа обрабатываются как один объект при передаче через конвейер или с помощью параметров, поддерживающих массивы объектов .
Дополнительные сведения см. в разделе System.Tuple.