Generic Instance Method 総称体インスタンスメソッド

withUTF8(_:)

Runs body over the content of this string in contiguous memory. If this string is not contiguous, this will first make it contiguous, which will also speed up subsequent access. If this mutates the string, it will invalidate any pre-existing indices. bodyを、隣接メモリの中のこの文字列の内容に対して実行します。この文字列が隣接しないならば、これは最初にそれを隣接させます、それはまた後に続くアクセスの速度を上げるでしょう。これが文字列を変化させるならば、それはあらゆる前から存在するインデックスを無効にするでしょう。

Declaration 宣言 

mutating func withUTF8<R>(_ body: (UnsafeBufferPointer<UInt8>) throws -> R) rethrows -> R

Discussion 解説

Note that it is unsafe to escape the pointer provided to body. For example, strings of up to 15 UTF-8 code units in length may be represented in a small-string representation, and thus will be spilled into temporary stack space which is invalid after withUTF8 finishes execution. bodyに提供されたポインタをエスケープすることは安全でないことに注意してください。例えば、長さで15 UTF-8コード単位までの文字列は、ある小さな文字列表現で表されるかもしれません、そしてそれゆえ一時スタック空間へとこぼされるでしょう、それはwithUTF8が遂行を終了する後に無効にされます。

Complexity: O(n) if non-contiguous, O(1) if already contiguous 計算量：O(n)、もし非隣接ならば、O(1)、もしすでに隣接ならば。

See Also 参照

Working with Encodings エンコーディングを扱う

static var availableStringEncodings: [String.Encoding]
Returns an Array of the encodings string objects support in the application’s environment. アプリケーションの環境においてサポートされる符号化文字列オブジェクトの配列を返します。
static var defaultCStringEncoding: String.Encoding
Returns the C-string encoding assumed for any method accepting a C string as an argument. C文字列を引数として受け入れる何らかのメソッドのために仮定されるC文字列符号化を返します。
static func localizedName(of: String.Encoding) -> String
Returns a human-readable string giving the name of a given encoding. 与えられた符号化の名前を与えている、人間が読む文字列を返します。
var isContiguousUTF8: Bool
Returns whether this string is capable of providing access to validly-encoded UTF-8 contents in contiguous memory in O(1) time. この文字列が、有効に符号化されたUTF-8内容に隣接メモリにおいて O(1) 時間でアクセスを提供する能力があるかどうかを返します。
func makeContiguousUTF8()
If this string is not contiguous, make it so. If this mutates the string, it will invalidate any pre-existing indices. この文字列が隣接しないならば、それをそうします。これが文字列を変化させるならば、それはあらゆる前から存在するインデックスを無効にするでしょう。