7.8.1 Oggetti Queue

La classe Queue implementa gli oggetti coda e possiede i metodi descritti qui sotto. Da questa classe si pu derivare in modo da ottenere altre organizzazioni di coda (e.g. stack) ma l'interfaccia ereditabile non qui descritta. Leggere il codice sorgente per i dettagli. I metodi pubblici sono:

qsize( )
Restituisce la dimensione approssimativa della coda. A causa delle semantiche multithread, questo valore non attendibile.

empty( )
Restituisce True se la coda vuota, False altrimenti. A causa delle semantiche multithread, questo valore non attendibile.

full( )
Restituisce True se la coda piena, False altrimenti. A causa delle semantiche multithread, questo numero non attendibile.

put( item[, block[, timeout]])
Aggiunge item nella coda. Se l'argomento opzionale block vero e timeout None (predefinito), si blocca se necessario, finch non sia disponibile una posizione libera. Se timeout un numero positivo, si blocca fino allo scadere di timeout secondi e solleva l'eccezione Full se nessuna posizione libera si resa disponibile in quel periodo. Altrimenti (block falso), aggiunge un elemento nella coda se una posizione libera immediatamente disponibile, altrimenti solleva l'eccezione Full (timeout viene, in quel caso, ignorato).

Nuovo nella versione 2.3: il parametro timeout.

put_nowait( item)
Equivalente a put(item, False).

get( [block[, timeout]])
Rimuove e restituisce un elemento dalla coda. Se l'argomento facoltativo block vero e timeout None (predefinito), si blocca se necessario fino a che un elemento sia disponibile. Se timeout un numero positivo, si blocca per timeout secondi e solleva l'eccezione Empty se nessun elemento si reso disponibile in quel periodo. Altrimenti (block falso), restituisce un elemento se ce n' uno immediatamente disponibile, altrimenti solleva l'eccezione Empty (timeout viene ignorato in questo caso).

Nuovo nella versione 2.3: il parametro timeout.

get_nowait( )
Equivalente a get(False).
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.