about_For

Краткое описание

Описывает команду языка, используемую для выполнения инструкций на основе условного теста.

Длинное описание

Оператор for (также известный как цикл for) — это конструкция языка, которую можно использовать для создания цикла, запускающего команды в блоке команд, в то время как указанное условие оценивается как $true.

Обычное использование цикла for заключается в итерации массива значений и работе с подмножеством этих значений. В большинстве случаев, если вы хотите выполнить итерацию всех значений в массиве, рассмотрите возможность использования оператора foreach.

Синтаксис

Ниже показан синтаксис инструкции for.

for (<Init>; <Condition>; <Repeat>)
{
    <Statement list>
}

Заполнитель Init представляет одну или несколько команд, выполняемых перед началом цикла. Обычно для создания и инициализации переменной с начальным значением обычно используется Init инструкции.

Эта переменная будет основой для проверки условия в следующей части инструкции for.

Заполнитель условия представляет часть инструкции for, которая разрешается в значение $true или $falseлогических. PowerShell вычисляет условие при каждом запуске цикла for. Если инструкция $true, команды в блоке команд выполняются снова, а инструкция вычисляется снова. Если условие по-прежнему $true, команды в списке инструкций выполняются снова. Цикл повторяется, пока условие не станет $false.

Заполнитель Repeat представляет одну или несколько команд, разделенных запятыми, которые выполняются при каждом повторе цикла. Как правило, это используется для изменения переменной, тестируемой внутри условия части инструкции.

Список инструкций заполнитель представляет набор одной или нескольких команд, выполняемых каждый раз при вводе или повторе цикла. Содержимое списка инструкций окружены фигурными скобками.

Поддержка нескольких операций

Следующие синтаксисы поддерживаются для нескольких операций назначения в инструкции init :

# Comma separated assignment expressions enclosed in parentheses.
for (($i = 0), ($j = 0); $i -lt 10; $i++)
{
    "`$i:$i"
    "`$j:$j"
}

# Sub-expression using the semicolon to separate statements.
for ($($i = 0;$j = 0); $i -lt 10; $i++)
{
    "`$i:$i"
    "`$j:$j"
}

Следующие синтаксисы поддерживаются для нескольких операций назначения в инструкции Repeat:

# Comma separated assignment expressions.
for (($i = 0), ($j = 0); $i -lt 10; $i++, $j++)
{
    "`$i:$i"
    "`$j:$j"
}

# Comma separated assignment expressions enclosed in parentheses.
for (($i = 0), ($j = 0); $i -lt 10; ($i++), ($j++))
{
    "`$i:$i"
    "`$j:$j"
}

# Sub-expression using the semicolon to separate statements.
for ($($i = 0;$j = 0); $i -lt 10; $($i++;$j++))
{
    "`$i:$i"
    "`$j:$j"
}

Заметка

Операции, отличные от предварительных или постовых добавок, могут не работать со всеми синтаксисами.

Для нескольких условий использовать логические операторы, как показано в следующем примере.

for (($i = 0), ($j = 0); $i -lt 10 -and $j -lt 10; $i++,$j++)
{
    "`$i:$i"
    "`$j:$j"
}

Дополнительные сведения см. в about_Logical_Operators.

Примеры синтаксиса

Как минимум, оператор for требует скобки вокруг Init, условияи повторять часть инструкции и команду, окруженную скобками в списке инструкций части инструкции.

Обратите внимание, что предстоящие примеры намеренно отображают код за пределами инструкции for. В последующих примерах код интегрируется в инструкцию for.

Например, следующая инструкция for постоянно отображает значение переменной $i, пока не вырваться из команды вручную, нажав клавиши CTRL+C.

$i = 1
for (;;)
{
    Write-Host $i
}

Дополнительные команды можно добавить в список инструкций, чтобы значение $i увеличивается на 1 при каждом запуске цикла, как показано в следующем примере.

for (;;)
{
    $i++; Write-Host $i
}

Пока команда не завершится, нажав клавиши CTRL+C, эта инструкция будет постоянно отображать значение переменной $i, так как она увеличивается на 1 при каждом запуске цикла.

Вместо изменения значения переменной в списке инструкций for можно использовать повторять часть инструкции for, как показано ниже.

$i=1
for (;;$i++)
{
    Write-Host $i
}

Эта инструкция по-прежнему будет повторяться неограниченно до тех пор, пока не завершите выполнение команды, нажав клавиши CTRL+C.

Можно завершить цикл for с помощью условия . Условие можно поместить с помощью условия части инструкции for. Цикл for завершается, когда условие оценивается как $false.

В следующем примере цикл for выполняется, пока значение $i меньше или равно 10.

$i=1
for(;$i -le 10;$i++)
{
    Write-Host $i
}

Вместо создания и инициализации переменной за пределами инструкции for эту задачу можно выполнить внутри цикла for с помощью Init части инструкции for.

for($i=1; $i -le 10; $i++){Write-Host $i}

Для разделителя Init, условийи повторять части инструкции for можно использовать каретки. В следующем примере показан for, использующий этот альтернативный синтаксис.

for ($i = 0
  $i -lt 10
  $i++){
  $i
}

Эта альтернативная форма инструкции for работает в файлах скриптов PowerShell и в командной строке PowerShell. Однако при вводе интерактивных команд в командной строке проще использовать синтаксис инструкции for с запятой.

Цикл for является более гибким, чем цикл foreach, так как позволяет увеличивать значения в массиве или коллекции с помощью шаблонов. В следующем примере переменная $i увеличивается на 2 в части Repeat инструкции for.

for ($i = 0; $i -le 20; $i += 2)
{
    Write-Host $i
}

Цикл for также можно записать в одной строке, как показано в следующем примере.

for ($i = 0; $i -lt 10; $i++){Write-Host $i}

Функциональный пример

В следующем примере показано, как использовать цикл for для итерации по массиву файлов и переименовать их. Файлы в папке work_items имеют идентификатор рабочего элемента в качестве имени файла. Цикл выполняет итерацию по файлам, чтобы убедиться, что номер идентификатора равен нулю до пяти цифр.

Во-первых, код извлекает список файлов данных рабочих элементов. Они все JSON-файлы, использующие формат <work-item-type>-<work-item-number> для их имени. С помощью объектов сведений о файле, сохраненных в переменной $fileList, их можно отсортировать по имени и увидеть, что при группировке элементов по типу порядок элементов по идентификатору непредвиден.

$fileList = Get-ChildItem -Path ./work_items
$fileList | Sort-Object -Descending -Property Name

bug-219.json
bug-41.json
bug-500.json
bug-697.json
bug-819.json
bug-840.json
feat-176.json
feat-367.json
feat-373.json
feat-434.json
feat-676.json
feat-690.json
feat-880.json
feat-944.json
maint-103.json
maint-367.json
maint-454.json
maint-49.json
maint-562.json
maint-579.json

Чтобы убедиться, что рабочие элементы можно отсортировать буквенно,номера рабочих элементов должны быть отсчитываются от нуля.

Код делает это путем первого поиска рабочего элемента с самым длинным числовым суффиксом. Он циклирует файлы с помощью цикла for, используя индекс для доступа к каждому файлу в массиве. Он сравнивает каждое имя файла с шаблоном регулярного выражения, чтобы извлечь номер рабочего элемента в виде строки вместо целого числа. Затем он сравнивает длину номеров рабочих элементов, чтобы найти самое длинное число.

# Default the longest numeral count to 1, since it can't be smaller.
$longestNumeralCount = 1

# Regular expression to find the numerals in the filename - use a template
# to simplify updating the pattern as needed.
$patternTemplate = '-(?<WorkItemNumber>{{{0},{1}}})\.json'
$pattern         =  $patternTemplate -f $longestNumeralCount

# Iterate, checking the length of the work item number as a string.
for (
    $i = 0                 # Start at zero for first array item.
    $i -lt $fileList.Count # Stop on the last item in the array.
    $i++                   # Increment by one to step through the array.
) {
    if ($fileList[$i].Name -match $pattern) {
        $numeralCount = $Matches.WorkItemNumber.Length
        if ($numeralCount -gt $longestNumeralCount) {
            # Count is higher, check against it for remaining items.
            $longestNumeralCount = $numeralCount
            # Update the pattern to speed up the search, ignoring items
            # with a smaller numeral count using pattern matching.
            $pattern = $patternTemplate -f $longestNumeralCount
        }
    }
}

Теперь, когда вы знаете максимальное число рабочих элементов, вы можете циклировать файлы, чтобы переименовать их по мере необходимости. Следующий фрагмент кода снова выполняет итерацию по списку файлов, забив их по мере необходимости. Он использует другой шаблон регулярного выражения для обработки только файлов с числовым числом меньше максимального.

# Regular expression to find the numerals in the filename, but only if the
# numeral count is smaller than the longest numeral count.
$pattern = $patternTemplate -f 1, ($longestNumeralCount - 1)
for (
    $i = 0                 # Start at zero for first array item.
    $i -lt $fileList.Count # Stop on the last item in the array.
    $i++                   # Increment by one to step through the array.
) {
    # Get the file from the array to process
    $file = $fileList[$i]

    # If the file doesn't need to be renamed, continue to the next file
    if ($file.Name -notmatch $pattern) {
        continue
    }

    # Get the work item number from the regular expression, create the
    # padded string from it, and define the new filename by replacing
    # the original number string with the padded number string.
    $workItemNumber = $Matches.WorkItemNumber
    $paddedNumber   = "{0:d$longestNumeralCount}" -f $workItemNumber
    $paddedName     = $file.Name -replace $workItemNumber, $paddedNumber

    # Rename the file with the padded work item number.
    $file | Rename-Item -NewName $paddedName
}

Теперь, когда файлы переименованы, вы можете получить список файлов снова и отсортировать старые и новые файлы по имени. Следующий фрагмент кода снова извлекает файлы для сохранения в новом массиве и сравнения с исходным набором объектов. Затем он сортирует оба массива файлов, сохраняя отсортированные массивы в новые переменные $sortedOriginal и $sortedPadded. Наконец, он использует цикл for для итерации по массивам и вывода объекта со следующими свойствами:

Индекс представляет текущий индекс в отсортированных массивах.
Исходный — это элемент в отсортированного массива исходных имен файлов по текущему индексу.
Padded — это элемент в отсортированном массиве отсортированных имен файлов по текущему индексу.

$paddedList = Get-ChildItem -Path ./work_items

# Sort both file lists by name.
$sortedOriginal = $fileList    | Sort-Object -Property Name
$sortedPadded   = $renamedList | Sort-Object -Property Name

# Iterate over the arrays and output an object to simplify comparing how
# the arrays were sorted before and after padding the work item numbers.
for (
  $i = 0
  $i -lt $fileList.Count
  $i++
) {
    [pscustomobject] @{
        Index    = $i
        Original = $sortedOriginal[$i].Name
        Padded   = $sortedPadded[$i].Name
    }
}

Index Original       Padded
----- --------       ------
    0 bug-219.json   bug-00041.json
    1 bug-41.json    bug-00219.json
    2 bug-500.json   bug-00500.json
    3 bug-697.json   bug-00697.json
    4 bug-819.json   bug-00819.json
    5 bug-840.json   bug-00840.json
    6 feat-176.json  feat-00176.json
    7 feat-367.json  feat-00367.json
    8 feat-373.json  feat-00373.json
    9 feat-434.json  feat-00434.json
   10 feat-676.json  feat-00676.json
   11 feat-690.json  feat-00690.json
   12 feat-880.json  feat-00880.json
   13 feat-944.json  feat-00944.json
   14 maint-103.json maint-00049.json
   15 maint-367.json maint-00103.json
   16 maint-454.json maint-00367.json
   17 maint-49.json  maint-00454.json
   18 maint-562.json maint-00562.json
   19 maint-579.json maint-00579.json

В выходных данных отсортированные рабочие элементы после заполнения находятся в ожидаемом порядке.

См. также

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-02-05