IDataOutput.WriteUTF(String) Metode

Definisi

Menulis dua byte informasi panjang ke aliran output, diikuti oleh representasi UTF-8 yang dimodifikasi dari setiap karakter dalam 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")]
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

Parameter

s
String

nilai string yang akan ditulis.

Atribut

Pengecualian

jika terjadi kesalahan I/O saat menulis.

Keterangan

Menulis dua byte informasi panjang ke aliran output, diikuti oleh representasi UTF-8 yang dimodifikasi dari setiap karakter dalam string s. Jika s adalah null, dilemparkan NullPointerException . Setiap karakter dalam string s dikonversi ke grup satu, dua, atau tiga byte, tergantung pada nilai karakter.

Jika karakter c berada dalam rentang &#92;u0001 melalui &#92;u007f, karakter diwakili oleh satu byte:

(byte)c

Jika karakter c berada &#92;u0000 atau berada dalam rentang &#92;u0080 melalui &#92;u07ff, maka karakter tersebut diwakili oleh dua byte, untuk ditulis dalam urutan yang ditampilkan:

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

Jika karakter c berada dalam rentang &#92;u0800 melalui uffff, maka karakter diwakili oleh tiga byte, untuk ditulis dalam urutan yang ditunjukkan:

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

Pertama, jumlah total byte yang diperlukan untuk mewakili semua karakter s dihitung. Jika angka ini lebih besar dari 65535, maka akan UTFDataFormatException dilemparkan. Jika tidak, panjang ini ditulis ke aliran output dengan cara yang tepat dari writeShort metode; setelah ini, representasi satu, dua, atau tiga byte dari setiap karakter dalam string s ditulis.

Byte yang ditulis oleh metode ini dapat dibaca dengan readUTF metode antarmuka DataInput , yang kemudian akan mengembalikan sama String dengan s.

Java dokumentasi untuk java.io.DataOutput.writeUTF(java.lang.String).

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Berlaku untuk

Lihat juga