Instance Method インスタンスメソッド

data(using:allowLossyConversion:)

Returns an NSData object containing a representation of the receiver encoded using a given encoding. あるNSDataオブジェクトを返します、与えられた符号化を使って符号化されるレシーバの表現を含んでいます。

Declaration 宣言

func data(using encoding: UInt, 
allowLossyConversion lossy: Bool) -> Data?

Parameters パラメータ

encoding: A string encoding. For possible values, see NSStringEncoding. 文字列符号化。可能な値として、NSStringEncodingを見てください。
flag: If true, then allows characters to be removed or altered in conversion. trueならば、そのとき文字が削除されるまたは改められるのを変換において許可します。

Return Value 戻り値

An NSData object containing a representation of the receiver encoded using encoding. Returns nil if flag is false and the receiver can’t be converted without losing some information (such as accents or case). あるNSDataオブジェクトで、encodingを使って符号化されたレシーバのある表現を含んでいます。nilを返します、もしflagがfalseであるそしてレシーバが何らかの情報（例えばアクセント符号やケース）の損失なしに変換されることができないならば。

Discussion 議論

If flag is true and the receiver can’t be converted without losing some information, some characters may be removed or altered in conversion. For example, in converting a character from NSUnicodeStringEncoding to NSASCIIStringEncoding, the character ‘Á’ becomes ‘A’, losing the accent. flagがtrueであるそしてレシーバが何らかの情報の損失なしに変換されることができないならば、いくつかの文字は変換において削除または改められます。例えば、NSUnicodeStringEncodingからNSASCIIStringEncodingへの文字の変換において、文字 ‘Á’ は ‘A’ になります、アクセント符号を失って。

This method creates an external representation (with a byte order marker, if necessary, to indicate endianness) to ensure that the resulting NSData object can be written out to a file safely. The result of this method, when lossless conversion is made, is the default “plain text” format for encoding and is the recommended way to save or transmit a string object. このメソッドは、ある外部表現を作成することで（エンディアン状態を指し示すために、必要に応じて、バイトオーダーマーカーとともに）、結果のNSDataオブジェクトがファイルへと安全に書き出されることを確実にします。このメソッドの結果は、可逆変換がなされる場合、符号化に対する省略時の “plain text” 形式です、そして文字列オブジェクトを保存または送信する推奨される方法です。

See Also 参照

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

class var availableStringEncodings: UnsafePointer<UInt>

Returns a zero-terminated list of the encodings string objects support in the application’s environment. アプリケーションのもつ環境においてサポートされる符号化の文字列オブジェクトからなるゼロ終端されたリストを返します。

class var defaultCStringEncoding: UInt

Returns the C-string encoding assumed for any method accepting a C string as an argument. C文字列を引数として受け入れる何らかのメソッドのために仮定されるC文字列符号化を返します。

class func stringEncoding(for: Data, encodingOptions: [StringEncodingDetectionOptionsKey : Any]?, convertedString: AutoreleasingUnsafeMutablePointer<NSString?>?, usedLossyConversion: UnsafeMutablePointer<ObjCBool>?) -> UInt

Returns the string encoding for the given data as detected by attempting to create a string according to the specified encoding options. 与えられたデータに対する文字列符号化を返します、指定された符号化オプションによって文字列を作成することを試みることによって検出されるとおりに。

class func localizedName(of: UInt) -> String

Returns a human-readable string giving the name of a given encoding. 与えられた符号化の名前を与えている、人間が読むことができる文字列を返します。

func canBeConverted(to: UInt) -> Bool

Returns a Boolean value that indicates whether the receiver can be converted to a given encoding without loss of information. あるブール値を返します、それはレシーバがある与えられた符号化へと情報の損失なしに変換されることができるかどうかを指し示します。

func data(using: UInt) -> Data?

var description: String

This NSString object. このNSStringオブジェクト。

var fastestEncoding: UInt

The fastest encoding to which the receiver may be converted without loss of information. レシーバが情報の損失なしに変換されるであろう最速の符号化。

var smallestEncoding: UInt

The smallest encoding to which the receiver can be converted without loss of information. レシーバが情報の損失無しに変換できる最小の符号化を返します。

struct StringEncodingDetectionOptionsKey

NSString Handling Exception Names NSStringが取り扱う例外の名前

These constants define the names of exceptions raised if NSString cannot represent a string in a given encoding, or parse a string as a property list. これらの定数は、NSStringが文字列をある与えられた符号化で表せない、または文字列をプロパティリストであると構文解析するならば引き起こされる例外の名前を定義します。