IDataOutput.WriteUTF(String) Metodo

Definizione

Spazio dei nomi:

Java.IO

Assembly:

Mono.Android.dll

Scrive due byte di informazioni sulla lunghezza nel flusso di output, seguita dalla rappresentazione UTF-8 modificata di ogni carattere nella stringa 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

Parametri

s

String

valore stringa da scrivere.

Attributi

RegisterAttribute

Eccezioni

IOException

se si verifica un errore di I/O durante la scrittura.

Commenti

Scrive due byte di informazioni sulla lunghezza nel flusso di output, seguita dalla rappresentazione UTF-8 modificata di ogni carattere nella stringa s. Se s è null, viene generata un'eccezione NullPointerException . Ogni carattere nella stringa s viene convertito in un gruppo di uno, due o tre byte, a seconda del valore del carattere.

Se un carattere si trova nell'intervallo c\u0001 tra \u007f, è rappresentato da un byte:

(byte)c

Se un carattere è o si trova \u0000 nell'intervallo c\u0080 tra \u07ff, viene rappresentato da due byte, da scrivere nell'ordine indicato:

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

Se un carattere è compreso nell'intervallo c\u0800 tra uffff, è rappresentato da tre byte, da scrivere nell'ordine indicato:

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

In primo luogo, viene calcolato il numero totale di byte necessari per rappresentare tutti i caratteri di s . Se questo numero è maggiore di 65535, viene generata un'eccezione UTFDataFormatException . In caso contrario, questa lunghezza viene scritta nel flusso di output esattamente nel modo del writeShort metodo. Successivamente, viene scritta la rappresentazione a uno, due o tre byte di ogni carattere nella stringa s .

I byte scritti da questo metodo possono essere letti dal readUTF metodo di interfaccia DataInput , che restituirà quindi un String valore uguale a s.

per java.io.DataOutput.writeUTF(java.lang.String).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Vedi anche

• ReadUTF()