IDataOutput.WriteUTF(String) Método

Definición

Escribe dos bytes de información de longitud en el flujo de salida, seguido de la representación UTF-8 modificada de cada carácter de la cadena 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

Parámetros

s
String

valor de cadena que se va a escribir.

Atributos

Excepciones

si se produce un error de E/S al escribir.

Comentarios

Escribe dos bytes de información de longitud en el flujo de salida, seguido de la representación UTF-8 modificada de cada carácter de la cadena s. Si s es null, se produce una NullPointerException excepción . Cada carácter de la cadena s se convierte en un grupo de uno, dos o tres bytes, en función del valor del carácter.

Si un carácter c está en el intervalo &#92;u0001 a través &#92;u007fde , se representa mediante un byte:

(byte)c

Si un carácter c es &#92;u0000 o está en el intervalo &#92;u0080 a través &#92;u07ffde , se representa mediante dos bytes para escribirse en el orden que se muestra:

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

Si un carácter c está en el intervalo &#92;u0800 a través uffffde , se representa mediante tres bytes para escribirse en el orden que se muestra:

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

En primer lugar, se calcula el número total de bytes necesarios para representar todos los caracteres de s . Si este número es mayor que 65535, se produce una UTFDataFormatException excepción . De lo contrario, esta longitud se escribe en el flujo de salida exactamente de la manera del writeShort método; después de esto, se escribe la representación de uno, dos o tres bytes de cada carácter de la cadena s .

Los bytes escritos por este método pueden leerse mediante el readUTF método de interfaz DataInput , que devolverá un String valor igual a s.

Java documentación para java.io.DataOutput.writeUTF(java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

Consulte también