Type Method 型メソッド

leadSurrogate(_:)

Returns the high-surrogate code unit of the surrogate pair representing the specified Unicode scalar. 指定されたユニコードスカラーを表しているサロゲートペアの上位サロゲートコード単位を返します。

Declaration 宣言

static func leadSurrogate(_ x: Unicode.Scalar) -> UTF16.CodeUnit

Parameters パラメータ

x

A Unicode scalar value. x must be represented by a surrogate pair when encoded in UTF-16. To check whether x is represented by a surrogate pair, use UTF16.width(x) == 2. あるユニコードスカラー値。xは、UTF-16でエンコードされる時あるサロゲートペアで表現されなければなりません。xがあるサロゲートペアで表現されるかどうか調べるには、UTF16.width(x) == 2を使ってください。

Return Value 戻り値

The leading surrogate code unit of x when encoded in UTF-16. UTF-16でエンコードされる時のxの先行サロゲートペア。

Discussion 解説

Because a Unicode scalar value can require up to 21 bits to store its value, some Unicode scalars are represented in UTF-16 by a pair of 16-bit code units. The first and second code units of the pair, designated leading and trailing surrogates, make up a surrogate pair. あるユニコードスカラー値はそれの値を格納するのに21ビットに至るまで要求できるので、いくつかのユニコードスカラーはUTF-16ではペア(一対)の16ビットコード単位によって表現されます。このペアの最初と2番目のコード単位、先行および後続サロゲートと呼ばれるものが、ひとつのサロゲートペアを作り上げます。


let apple: Unicode.Scalar = "🍎"
print(UTF16.leadSurrogate(apple))
// Prints "55356"