Buffer Classe

Definizione

[Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)]
public abstract class Buffer : Java.Lang.Object

[<Android.Runtime.Register("java/nio/Buffer", DoNotGenerateAcw=true)>]
type Buffer = class
    inherit Object

Ereditarietà

Object

JavaObject

Object

Buffer

Derivato

Java.Nio.ByteBuffer

Java.Nio.CharBuffer

Java.Nio.DoubleBuffer

Java.Nio.FloatBuffer

Java.Nio.IntBuffer

Altro…

Attributi

RegisterAttribute

Commenti

Contenitore per i dati di un tipo primitivo specifico.

Un buffer è una sequenza lineare e finita di elementi di un tipo primitivo specifico. Oltre al contenuto, le proprietà essenziali di un buffer sono la capacità, il limite e la posizione:

<blockquote>

La capacità di un buffer è il numero di elementi che contiene. La capacità di un buffer non è mai negativa e non cambia mai.

Il limite di un buffer è l'indice del primo elemento che non deve essere letto o scritto. Il limite di un buffer non è mai negativo e non è mai maggiore della sua capacità.

La posizione di un buffer è l'indice dell'elemento successivo da leggere o scrivere. La posizione di un buffer non è mai negativa e non è mai maggiore del limite.

</blockquote>

Esiste una sottoclasse di questa classe per ogni tipo primitivo non booleano.

<h2> Trasferimento di dati </h2>

Ogni sottoclasse di questa classe definisce due categorie di operazioni get e put :

<blockquote>

Le operazioni relative leggono o scrivono uno o più elementi a partire dalla posizione corrente e quindi incrementano la posizione in base al numero di elementi trasferiti. Se il trasferimento richiesto supera il limite, un'operazione get relativa genera un'eccezione BufferUnderflowException e un'operazione put relativa genera un'eccezione BufferOverflowException; in entrambi i casi, non viene trasferito alcun dato.

Le operazioni assolute accettano un indice di elemento esplicito e non influiscono sulla posizione. Le operazioni get e putassolute generano un'eccezione IndexOutOfBoundsException se l'argomento indice supera il limite.

</blockquote>

I dati possono anche essere trasferiti all'interno o all'esterno di un buffer dalle operazioni di I/O di un canale appropriato, che sono sempre relative alla posizione corrente.

<h2> Contrassegno e reimpostazione <di /h2>

Il contrassegno di un buffer è l'indice a cui verrà reimpostata la posizione quando viene richiamato il #reset reset metodo. Il contrassegno non è sempre definito, ma quando viene definito non è mai negativo e non è mai maggiore della posizione. Se il contrassegno viene definito, viene rimosso quando la posizione o il limite viene regolato su un valore inferiore al contrassegno. Se il contrassegno non è definito, richiamando il #reset reset metodo viene generata un'eccezione InvalidMarkException .

<h2> Invariants </h2>

I seguenti blocchi invarianti per i valori di contrassegno, posizione, limite e capacità:

<blockquote>0<=mark position<=<=limit<=capacity</blockquote>

Un buffer appena creato ha sempre una posizione pari a zero e un contrassegno non definito. Il limite iniziale può essere zero oppure può essere un altro valore che dipende dal tipo del buffer e dal modo in cui viene costruito. Ogni elemento di un buffer appena allocato viene inizializzato su zero.

<h2> Operazioni aggiuntive </h2>

Oltre ai metodi per accedere ai valori di posizione, limite e capacità e per contrassegnare e reimpostare, questa classe definisce anche le operazioni seguenti sui buffer:

<ul>

<li>

#clear rende un buffer pronto per una nuova sequenza di operazioni put relative o di lettura canale: imposta il limite sulla capacità e la posizione su zero.

</li>

<li>

#flip rende un buffer pronto per una nuova sequenza di operazioni get relative o di scrittura del canale: imposta il limite sulla posizione corrente e quindi imposta la posizione su zero.

</li>

<li>

#rewind rende un buffer pronto per la rilettura dei dati già contenuti: lascia invariato il limite e imposta la posizione su zero.

</li>

<li>

I #slice metodi e #slice(int,int) slice(index,length) creano una sottosequenza di un buffer: lasciano invariato il limite e la posizione.

</li>

<li>

#duplicate crea una copia superficiale di un buffer: lascia invariato il limite e la posizione.

</li>

</ul>

<h2> Buffer di <sola lettura /h2>

Ogni buffer è leggibile, ma non tutti i buffer sono scrivibili. I metodi di mutazione di ogni classe buffer vengono specificati come operazioni facoltative che generano un'eccezione ReadOnlyBufferException quando viene richiamata su un buffer di sola lettura. Un buffer di sola lettura non consente la modifica del contenuto, ma i valori di contrassegno, posizione e limite sono modificabili. Indica se un buffer è di sola lettura può essere determinato richiamando il relativo #isReadOnly isReadOnly metodo.

<h2> Thread safety </h2>

I buffer non sono sicuri per l'uso da parte di più thread simultanei. Se un buffer deve essere usato da più thread, l'accesso al buffer deve essere controllato dalla sincronizzazione appropriata.

<concatenamento >delle chiamate h2< /h2>

I metodi in questa classe che non dispongono di un valore da restituire vengono specificati per restituire il buffer su cui vengono richiamati. In questo modo è possibile concatenare le chiamate al metodo; Ad esempio, la sequenza di istruzioni

<blockquote>

b.flip();
            b.position(23);
            b.limit(42);

</blockquote>

può essere sostituito dalla singola istruzione più compatta

<blockquote>

b.flip().position(23).limit(42);

</blockquote>

Aggiunta nella versione 1.4.

Documentazione java per java.nio.Buffer.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.