range()

  • Článek

Vygeneruje dynamické pole obsahující řadu stejně rozmístěných hodnot.

Syntax

range(Spustit,stop [,step])

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Typ Vyžadováno Popis
Spustit Skalár ✔️ Hodnota prvního prvku ve výsledném poli.
Stop Skalár ✔️ Maximální hodnota posledního prvku ve výsledné matici, takže poslední hodnota v řadě je menší nebo rovna hodnotě stop.
Krok Skalár Rozdíl mezi dvěma po sobě jdoucími prvky pole. Výchozí hodnota kroku je 1 pro číselnou hodnotu a 1h pro timespan nebo datetime.

Návraty

Dynamické pole, jehož hodnoty jsou: start, počáteční + krok, ... do a včetně zastávky. Pokud je dosaženo maximálního povoleného počtu výsledků, pole se zkrátí.

Poznámka

Funkce rozsahu podporuje maximálně 1 048 576 (2^20) výsledků.

Příklady

Následující příklad vrátí matici čísel od jednoho do osmi s přírůstkem tři.

Spuštění dotazu

print r = range(1, 8, 3)

Výstup

r
[1,4,7]

Následující příklad vrátí pole se všemi daty z roku 2007.

Spuštění dotazu

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

Výstup

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

Následující příklad vrátí matici s čísly mezi jedním a třemi.

Spuštění dotazu

print range(1, 3)

Výstup

print_0
[1,2,3]

Následující příklad vrátí rozsah hodin od jedné hodiny do pěti hodin.

Spuštění dotazu

print range(1h, 5h)

Výstup

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

Následující příklad vrátí zkrácenou matici, protože oblast překračuje maximální limit výsledků. Příklad ukazuje překročení limitu pomocí operátoru mv-expand k rozšíření pole do více záznamů a následnému počítání počtu záznamů.

Spuštění dotazu

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

Výstup

Počet
1 048 576