IDataOutput.WriteUTF(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 \u0001 a través \u007fde , se representa mediante un byte:
(byte)c
Si un carácter c es \u0000 o está en el intervalo \u0080 a través \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 \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.