range()

  • Articolo

Genera una matrice dinamica contenente una serie di valori equamente spaziati.

Sintassi

range(Iniziare,stop [,step])

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
start scalare ✔️ Valore del primo elemento nella matrice risultante.
stop scalare ✔️ Valore massimo dell'ultimo elemento nella matrice risultante, in modo che l'ultimo valore della serie sia minore o uguale al valore di arresto.
Passo scalare Differenza tra due elementi consecutivi della matrice. Il valore predefinito per step è 1 per numeric e 1h per timespan o datetime.

Restituisce

Matrice dinamica i cui valori sono: start, start + step, ... fino a e incluso stop. La matrice viene troncata se viene raggiunto il numero massimo di risultati consentiti.

Nota

La funzione range supporta un massimo di 1.048.576 (2^20) risultati.

Esempio

Nell'esempio seguente viene restituita una matrice di numeri da uno a otto, con un incremento di tre.

Eseguire la query

print r = range(1, 8, 3)

Output

r
[1,4,7]

Nell'esempio seguente viene restituita una matrice con tutte le date dell'anno 2007.

Eseguire la query

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

Output

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"]

Nell'esempio seguente viene restituita una matrice con numeri compresi tra uno e tre.

Eseguire la query

print range(1, 3)

Output

print_0
[1,2,3]

Nell'esempio seguente viene restituito un intervallo di ore compreso tra un'ora e cinque ore.

Eseguire la query

print range(1h, 5h)

Output

print_0
1\.000.000
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]:

Nell'esempio seguente viene restituita una matrice troncata perché l'intervallo supera il limite massimo di risultati. Nell'esempio viene illustrato che il limite viene superato usando l'operatore mv-expand per espandere la matrice in più record e quindi contare il numero di record.

Eseguire la query

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

Output

Conteggio
1.048.576