Przejdź do głównej zawartości

List.RemoveFirstN

Zwraca listę, na której pominięto określoną liczbę elementów znajdujących się na początku innej listy.

Syntax​

List.RemoveFirstN(
    list as list,
    optional countOrCondition as any
) as list

Remarks​

Zwraca listę, z której usunięto pierwszy element listy list. Jeśli lista list jest pusta, zwracana jest pusta lista.Ta funkcja przyjmuje opcjonalny parametr countOrCondition, który umożliwia usunięcie wielu wartości, tak jak opisano poniżej.

  • Jeśli jest określona liczba, zostanie usuniętych maksymalnie tyle elementów, ile wynosi ta liczba.
  • Jeśli jest określony warunek, zwracana lista zaczyna się od pierwszego elementu z listy list, który spełnia kryteria. Gdy zostanie znaleziony element, który nie spełnia warunku, nie będą analizowane dalsze elementy.
  • Jeśli ten parametr ma wartość null, jest stosowane zachowanie domyślne.

Examples​

Example #1​

Utwórz listę na podstawie listy {1, 2, 3, 4, 5} bez 3 pierwszych liczb.

List.RemoveFirstN({1, 2, 3, 4, 5}, 3)

Result:

{4, 5}

Example #2​

Utwórz na podstawie listy {5, 4, 2, 6, 1} listę, która rozpoczyna się od liczby mniejszej niż 3.

List.RemoveFirstN({5, 4, 2, 6, 1}, each _ > 3)

Result:

{2, 6, 1}

Category​

List.Transformation functions