InputStream.Read Méthode

[Android.Runtime.Register("read", "([BII)I", "GetRead_arrayBIIHandler")]
public virtual int Read(byte[]? b, int off, int len);

[<Android.Runtime.Register("read", "([BII)I", "GetRead_arrayBIIHandler")>]
abstract member Read : byte[] * int * int -> int
override this.Read : byte[] * int * int -> int

Paramètres

Retours

nombre total d’octets lus dans la mémoire tampon ou -1 s’il n’y a plus de données, car la fin du flux a été atteinte.

Attributs

RegisterAttribute

Exceptions

Remarques

Lit jusqu’à len des octets de données du flux d’entrée dans un tableau d’octets. Une tentative est effectuée pour lire autant d’octets len que d’octets, mais un nombre plus petit peut être lu. Le nombre d’octets réellement lus est retourné sous forme d’entier.

Cette méthode bloque jusqu’à ce que les données d’entrée soient disponibles, que la fin du fichier soit détectée ou qu’une exception soit levée.

Si len la valeur est égale à zéro, aucun octet n’est lu et 0 est retourné ; sinon, il existe une tentative de lecture d’au moins un octet. Si aucun octet n’est disponible, car le flux est à la fin du fichier, la valeur -1 est retournée ; sinon, au moins un octet est lu et stocké dans b.

La première lecture d’octets est stockée dans l’élément b[off], la suivante dans b[off+1], et ainsi de suite. Le nombre d’octets lus est, au plus, égal à len. Laissez k être le nombre d’octets réellement lus ; ces octets sont stockés dans des éléments b[off] par b[off+k-1], ce qui laisse les éléments b[off+k] sans b[off+len-1] effet.

Dans tous les cas, les éléments à travers b[0] et les éléments b[off-1]b[off+len] ne b[b.length-1] sont pas affectés.

La read(b, off, len) méthode pour la classe InputStream appelle simplement la méthode read() à plusieurs reprises. Si le premier appel de ce type aboutit à un IOException, cette exception est retournée de l’appel à la read(b,off,len) méthode. Si un appel ultérieur à read() un IOExceptionrésultat est obtenu, l’exception est interceptée et traitée comme s’il s’agissait d’une fin de fichier ; les octets lus jusqu’à ce point sont stockés b et le nombre d’octets lus avant que l’exception ne soit retournée. L’implémentation par défaut de cette méthode bloque jusqu’à ce que la quantité demandée de données len d’entrée ait été lue, que la fin du fichier soit détectée ou qu’une exception soit levée. Les sous-classes sont encouragées à fournir une implémentation plus efficace de cette méthode.

Java documentation pour java.io.InputStream.read(byte[], int, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("read", "()I", "GetReadHandler")]
public abstract int Read();

[<Android.Runtime.Register("read", "()I", "GetReadHandler")>]
abstract member Read : unit -> int

Retours

octet suivant des données, ou -1 si la fin du flux est atteinte.

Attributs

RegisterAttribute

Exceptions

Remarques

Lit l’octet suivant des données à partir du flux d’entrée. L’octet de valeur est retourné sous la forme d’une int plage 0 à 255. Si aucun octet n’est disponible, car la fin du flux a été atteinte, la valeur -1 est retournée. Cette méthode bloque jusqu’à ce que les données d’entrée soient disponibles, que la fin du flux soit détectée ou qu’une exception soit levée.

Une sous-classe doit fournir une implémentation de cette méthode.

Java documentation pour java.io.InputStream.read().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("read", "([B)I", "GetRead_arrayBHandler")]
public virtual int Read(byte[]? b);

[<Android.Runtime.Register("read", "([B)I", "GetRead_arrayBHandler")>]
abstract member Read : byte[] -> int
override this.Read : byte[] -> int

Paramètres

Retours

nombre total d’octets lus dans la mémoire tampon ou -1 s’il n’y a plus de données, car la fin du flux a été atteinte.

Attributs

RegisterAttribute

Exceptions

Remarques

Lit un certain nombre d’octets du flux d’entrée et les stocke dans le tableau de mémoires tampons b. Le nombre d’octets réellement lus est retourné sous forme d’entier. Cette méthode bloque jusqu’à ce que les données d’entrée soient disponibles, que la fin du fichier soit détectée ou qu’une exception soit levée.

Si la longueur est b égale à zéro, aucun octet n’est lu et 0 est retourné ; sinon, il existe une tentative de lecture d’au moins un octet. Si aucun octet n’est disponible, car le flux se trouve à la fin du fichier, la valeur -1 est retournée ; sinon, au moins un octet est lu et stocké dans b.

La première lecture d’octets est stockée dans l’élément b[0], la suivante dans b[1], et ainsi de suite. Le nombre d’octets lus est, au plus, égal à la longueur de b. Laissez k être le nombre d’octets réellement lus ; ces octets sont stockés dans des éléments b[0] par b[k-1], ce qui laisse les éléments b[k] sans b[b.length-1] effet.

La read(b) méthode pour la classe InputStream a le même effet que :

{@code read(b, 0, b.length) }

Java documentation pour java.io.InputStream.read(byte[]).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.