Langage

IDataOutput.WriteUTF(String) Méthode

Définition

Écrit deux octets d’informations de longueur dans le flux de sortie, suivi de la représentation UTF-8 modifiée de chaque caractère de la chaîne s.

[Android.Runtime.Register("writeUTF", "(Ljava/lang/String;)V", "GetWriteUTF_Ljava_lang_String_Handler:Java.IO.IDataOutputInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public void WriteUTF(string? s);
[<Android.Runtime.Register("writeUTF", "(Ljava/lang/String;)V", "GetWriteUTF_Ljava_lang_String_Handler:Java.IO.IDataOutputInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member WriteUTF : string -> unit

Paramètres

s
String

valeur de chaîne à écrire.

Attributs

Exceptions

si une erreur d’E/S se produit lors de l’écriture.

Remarques

Écrit deux octets d’informations de longueur dans le flux de sortie, suivi de la représentation UTF-8 modifiée de chaque caractère de la chaîne s. Si s c’est nullle cas, un NullPointerException est levée. Chaque caractère de la chaîne s est converti en groupe d’un, deux ou trois octets, en fonction de la valeur du caractère.

Si un caractère c se trouve dans la plage&#92;u007f&#92;u0001, il est représenté par un octet :

(byte)c

Si un caractère c est &#92;u0000 ou se trouve dans la plage&#92;u07ff&#92;u0080, il est représenté par deux octets, à écrire dans l’ordre indiqué :

{@code
            (byte)(0xc0 | (0x1f & (c >> 6)))
            (byte)(0x80 | (0x3f & c))
            }

Si un caractère c se trouve dans la plageuffff&#92;u0800, il est représenté par trois octets, à écrire dans l’ordre indiqué :

{@code
            (byte)(0xe0 | (0x0f & (c >> 12)))
            (byte)(0x80 | (0x3f & (c >>  6)))
            (byte)(0x80 | (0x3f & c))
            }

Tout d’abord, le nombre total d’octets nécessaires pour représenter tous les caractères d’est s calculé. Si ce nombre est supérieur 65535à , un UTFDataFormatException est levée. Sinon, cette longueur est écrite dans le flux de sortie exactement de la manière de la writeShort méthode ; après cela, la représentation un, deux ou trois octets de chaque caractère de la chaîne s est écrite.

Les octets écrits par cette méthode peuvent être lus par la readUTF méthode d’interface DataInput , qui retourne ensuite une String valeur égale à s.

Java documentation pour java.io.DataOutput.writeUTF(java.lang.String).

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.

S’applique à

Voir aussi