range()

Genererar en dynamisk matris med en serie med lika fördelade värden.

Syntax

range(Börja,stop [,step])

Läs mer om syntaxkonventioner.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
Börja	Skalär	✔️	Värdet för det första elementet i den resulterande matrisen.
Stanna	Skalär	✔️	Det maximala värdet för det sista elementet i den resulterande matrisen, så att det sista värdet i serien är mindre än eller lika med stoppvärdet.
Steg	Skalär		Skillnaden mellan två efterföljande element i matrisen. Standardvärdet för steget är 1 för numeriskt och 1h för timespan eller datetime.

Returer

En dynamisk matris vars värden är: start, startsteg + , ... upp till och inklusive stopp. Matrisen trunkeras om det maximala antalet tillåtna resultat uppnås.

Anteckning

Intervallfunktionen stöder högst 1 048 576 (2^20) resultat.

Exempel

I följande exempel returneras en matris med tal från en till åtta, med en ökning på tre.

Köra frågan

print r = range(1, 8, 3)

Resultat

r
[1,4,7]

I följande exempel returneras en matris med alla datum från år 2007.

Köra frågan

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

Resultat

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

I följande exempel returneras en matris med tal mellan en och tre.

Köra frågan

print range(1, 3)

Resultat

print_0
[1,2,3]

I följande exempel returneras ett intervall med timmar mellan en timme och fem timmar.

Köra frågan

print range(1h, 5h)

Resultat

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

I följande exempel returneras en trunkerad matris eftersom intervallet överskrider den maximala resultatgränsen. Exemplet visar att gränsen överskrids med operatorn mv-expand för att expandera matrisen till flera poster och sedan räkna antalet poster.

Köra frågan

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

Resultat

Antal
1 048 576