Initializer

init(cString:)

Creates a new string by copying the null-terminated UTF-8 data referenced by the given pointer. 新しい文字列を、与えられたポインタによって参照されるヌル終端のUTF-8データをコピーすることによって作成します。

Declaration 宣言

init(cString: UnsafePointer<CChar>)

Parameters パラメータ

cString: A pointer to a null-terminated UTF-8 code sequence. ヌル終端のコードシーケンスへのポインタ。

Discussion 解説

If cString contains ill-formed UTF-8 code unit sequences, this initializer replaces them with the Unicode replacement character ("\u{FFFD}"). cStringが文法的に正しくないUTF-8コードユニットシーケンスを含むならば、それらをある代替文字（"\u{FFFD}"）で置き換えます。

The following example calls this initializer with pointers to the contents of two different CChar arrays—the first with well-formed UTF-8 code unit sequences and the second with an ill-formed sequence at the end. 以下の例は、このイニシャライザを２つの異なるCChar配列の内容へのポインタとともに呼び出します—最初のものは正しい形式のUTF-8コード単位シーケンスをもち、そして２番目のものはある誤形式シーケンスを末尾に保ちます。

let validUTF8: [CChar] = [67, 97, 102, -61, -87, 0]
validUTF8.withUnsafeBufferPointer { ptr in
    let s = String(cString: ptr.baseAddress!)
    print(s)
}
// Prints "Café"


let invalidUTF8: [CChar] = [67, 97, 102, -61, 0]
invalidUTF8.withUnsafeBufferPointer { ptr in
    let s = String(cString: ptr.baseAddress!)
    print(s)
}
// Prints "Caf�"

Relationships 関係

From Protocol 由来プロトコル

StringProtocol

See Also 参照

Converting a C String C文字列を変換する

init?<S>(bytes: S, encoding: String.Encoding)

init?(bytesNoCopy: UnsafeMutableRawPointer, length: Int, encoding: String.Encoding, freeWhenDone: Bool)

Produces an initialized String object that contains a given number of bytes from a given buffer of bytes interpreted in a given encoding, and optionally frees the buffer. WARNING: this initializer is not memory-safe! 初期化されたStringオブジェクトを作成します、それは与えられた符号化での与えられたバイト解釈のバッファ由来の与えられた数のバイトを含んでいます、そして随意にそのバッファを解放します。警告：このイニシャライザはメモリ安全ではありません！

init(cString: UnsafePointer<UInt8>)

init?(cString: UnsafePointer<CChar>, encoding: String.Encoding)

Produces a string containing the bytes in a given C array, interpreted according to a given encoding. 与えられた符号化によって解釈される、与えられたC配列の中のバイトを含んでいる文字列を生成します。

init<Encoding>(decodingCString: UnsafePointer<Encoding.CodeUnit>, as: Encoding.Type)

Creates a string from the null-terminated sequence of bytes at the given pointer. 与えられたポインタでのnull終端のバイトシーケンスから文字列を作成します。

static func decodeCString<Encoding>(UnsafePointer<Encoding.CodeUnit>?, as: Encoding.Type, repairingInvalidCodeUnits: Bool) -> (result: String, repairsMade: Bool)?

Creates a new string by copying the null-terminated data referenced by the given pointer using the specified encoding. 新しい文字列を、与えられたポインタによって参照されるヌル終端のデータをコピーすることによって作成します、指定された符号化を使います。