Pipe.SinkChannel.Write Méthode

[Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;)I", "GetWrite_Ljava_nio_ByteBuffer_Handler")]
public abstract int Write(Java.Nio.ByteBuffer? src);

[<Android.Runtime.Register("write", "(Ljava/nio/ByteBuffer;)I", "GetWrite_Ljava_nio_ByteBuffer_Handler")>]
abstract member Write : Java.Nio.ByteBuffer -> int

Paramètres

Retours

Nombre d’octets écrits, éventuellement zéro

Implémente

Attributs

RegisterAttribute

Remarques

Écrit une séquence d’octets dans ce canal à partir de la mémoire tampon donnée.

Une tentative est effectuée pour écrire jusqu’à r octets dans le canal, où r correspond au nombre d’octets restants dans la mémoire tampon, autrement dit, src.remaining()au moment où cette méthode est appelée.

Supposons qu’une séquence d’octets de longueur n soit écrite, où 0  ;<=  ;n  ;<=  ;r. Cette séquence d’octets est transférée à partir de la mémoire tampon à partir de l’index p, où p est la position de la mémoire tampon au moment où cette méthode est appelée ; l’index du dernier octet écrit sera p  ;+  ;n  ;-  ;1. Lors du retour, la position de la mémoire tampon est égale à p  ;+  ;n ; sa limite n’aura pas changé.

Sauf indication contraire, une opération d’écriture ne retourne qu’après avoir écrit tous les octets demandés. Certains types de canaux, en fonction de leur état, peuvent écrire uniquement quelques-uns des octets ou éventuellement aucun du tout. Un canal de socket en mode non bloquant, par exemple, ne peut pas écrire plus d’octets que ce qui est libre dans la mémoire tampon de sortie du socket.

Cette méthode peut être appelée à tout moment. Si un autre thread a déjà lancé une opération d’écriture sur ce canal, toutefois, un appel de cette méthode se bloque jusqu’à ce que la première opération soit terminée.

Documentation Java pour java.nio.channels.WritableByteChannel.write(java.nio.ByteBuffer).

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

[Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;)J", "GetWrite_arrayLjava_nio_ByteBuffer_Handler")]
public abstract long Write(Java.Nio.ByteBuffer[]? srcs);

[<Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;)J", "GetWrite_arrayLjava_nio_ByteBuffer_Handler")>]
abstract member Write : Java.Nio.ByteBuffer[] -> int64

Paramètres

Retours

Nombre d’octets écrits, éventuellement zéro

Implémente

Attributs

RegisterAttribute

Remarques

Écrit une séquence d’octets dans ce canal à partir des mémoires tampons données.

Un appel de cette méthode du formulaire c.write(srcs) se comporte exactement de la même façon que l’appel

<blockquote>

c.write(srcs, 0, srcs.length);

</blockquote>

Documentation Java pour java.nio.channels.GatheringByteChannel.write(java.nio.ByteBuffer[]).

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

[Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;II)J", "GetWrite_arrayLjava_nio_ByteBuffer_IIHandler")]
public abstract long Write(Java.Nio.ByteBuffer[]? srcs, int offset, int length);

[<Android.Runtime.Register("write", "([Ljava/nio/ByteBuffer;II)J", "GetWrite_arrayLjava_nio_ByteBuffer_IIHandler")>]
abstract member Write : Java.Nio.ByteBuffer[] * int * int -> int64

Paramètres

Retours

Nombre d’octets écrits, éventuellement zéro

Implémente

Attributs

RegisterAttribute

Remarques

Écrit une séquence d’octets dans ce canal à partir d’une sous-séquence des mémoires tampons données.

Une tentative est effectuée pour écrire jusqu’à r octets dans ce canal, où r correspond au nombre total d’octets restants dans la sous-file d’attente spécifiée du tableau de mémoires tampons donné, autrement dit,

<blockquote>

srcs[offset].remaining()
                + srcs[offset+1].remaining()
                + ... + srcs[offset+length-1].remaining()

</blockquote>

au moment où cette méthode est appelée.

Supposons qu’une séquence d’octets de longueur n soit écrite, où 0  ;<=  ;n  ;<=  ;r. Jusqu’aux premiers srcs[offset].remaining() octets de cette séquence sont écrits à partir de la mémoire tampon srcs[offset], jusqu’aux octets suivants srcs[offset+1].remaining() sont écrits à partir de la mémoire tampon srcs[offset+1], et ainsi de suite, jusqu’à ce que la séquence d’octets entière soit écrite. Autant d’octets que possible sont écrits à partir de chaque mémoire tampon, donc la position finale de chaque mémoire tampon mise à jour, sauf la dernière mémoire tampon mise à jour, est garantie d’être égale à la limite de cette mémoire tampon.

Sauf indication contraire, une opération d’écriture ne retourne qu’après avoir écrit tous les octets demandés. Certains types de canaux, en fonction de leur état, peuvent écrire uniquement quelques-uns des octets ou éventuellement aucun du tout. Un canal de socket en mode non bloquant, par exemple, ne peut pas écrire plus d’octets que ce qui est libre dans la mémoire tampon de sortie du socket.

Cette méthode peut être appelée à tout moment. Si un autre thread a déjà lancé une opération d’écriture sur ce canal, toutefois, un appel de cette méthode se bloque jusqu’à ce que la première opération soit terminée.

Documentation Java pour java.nio.channels.GatheringByteChannel.write(java.nio.ByteBuffer[], int, int).

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