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.