range()

  • Artykuł

Generuje tablicę dynamiczną zawierającą serię wartości o równych odstępach.

Składnia

range(Uruchomić,stop [,krok])

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
Uruchomić Wartość skalarna ✔️ Wartość pierwszego elementu w wynikowej tablicy.
Zatrzymać Wartość skalarna ✔️ Maksymalna wartość ostatniego elementu w wynikowej tablicy, taka jak ostatnia wartość w serii jest mniejsza lub równa wartości stop.
Krok Wartość skalarna Różnica między dwoma kolejnymi elementami tablicy. Domyślną wartością kroku jest 1 wartość liczbowa i 1h dla timespan elementu lub datetime.

Zwraca

Tablica dynamiczna, której wartości to: start, krok rozpoczęcia + , ... maksymalnie do i włącznie z zatrzymaniem. Tablica jest obcięta, jeśli zostanie osiągnięta maksymalna dozwolona liczba wyników.

Uwaga

Funkcja range obsługuje maksymalnie 1 048 576 (2^20) wyniki.

Przykłady

Poniższy przykład zwraca tablicę liczb z jednej do ośmiu z przyrostem trzech.

Uruchamianie zapytania

print r = range(1, 8, 3)

Dane wyjściowe

r
[1,4,7]

Poniższy przykład zwraca tablicę ze wszystkimi datami z roku 2007.

Uruchamianie zapytania

print r = range(datetime(2007-01-01), datetime(2007-12-31), 1d)

Dane wyjściowe

r
["2007-01-01T00:00:00.000000Z","2007-01-02T00:00:00.00.000000Z","12007-01-03T00:00:00.0000000Z",.....,"2007-12-31T00:00:00.00.000000Z"]

Poniższy przykład zwraca tablicę z liczbami z przedziału od jednego do trzech.

Uruchamianie zapytania

print range(1, 3)

Dane wyjściowe

print_0
[1,2,3]

Poniższy przykład zwraca zakres godzin z zakresu od jednej godziny do pięciu godzin.

Uruchamianie zapytania

print range(1h, 5h)

Dane wyjściowe

print_0
1 000 000
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]:

Poniższy przykład zwraca obcinaną tablicę, ponieważ zakres przekracza maksymalny limit wyników. W przykładzie pokazano, że limit jest przekroczony przy użyciu operatora mv-expand , aby rozwinąć tablicę w wiele rekordów, a następnie zliczać liczbę rekordów.

Uruchamianie zapytania

print r = range(1,1000000000) 
| mv-expand r 
| count

Dane wyjściowe

Liczba
1 048 576