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

dataUsingEncoding:allowLossyConversion:

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

Declaration 宣言 

- (NSData *)dataUsingEncoding:(NSStringEncoding)encoding 
         allowLossyConversion:(BOOL)lossy;

Parameters パラメータ

encoding

A string encoding. For possible values, see NSStringEncoding. 文字列符号化。可能な値として、NSStringEncodingを見てください。

flag

If YES, then allows characters to be removed or altered in conversion. YESならば、そのとき文字が削除されるまたは改められるのを変換において許可します。

Return Value 戻り値

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

Discussion 議論

If flag is YES 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がYESであるそしてレシーバが何らかの情報の損失なしに変換されることができないならば、いくつかの文字は変換において削除または改められます。例えば、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 エンコーディングを扱う

availableStringEncodings
Returns a zero-terminated list of the encodings string objects support in the application’s environment. アプリケーションのもつ環境においてサポートされる符号化の文字列オブジェクトからなるゼロ終端されたリストを返します。
defaultCStringEncoding
Returns the C-string encoding assumed for any method accepting a C string as an argument. C文字列を引数として受け入れる何らかのメソッドのために仮定されるC文字列符号化を返します。
+ stringEncodingForData:encodingOptions:convertedString:usedLossyConversion:
Returns the string encoding for the given data as detected by attempting to create a string according to the specified encoding options. 与えられたデータに対する文字列符号化を返します、指定された符号化オプションによって文字列を作成することを試みることによって検出されるとおりに。
+ localizedNameOfStringEncoding:
Returns a human-readable string giving the name of a given encoding. 与えられた符号化の名前を与えている、人間が読むことができる文字列を返します。
- canBeConvertedToEncoding:
Returns a Boolean value that indicates whether the receiver can be converted to a given encoding without loss of information. あるブール値を返します、それはレシーバがある与えられた符号化へと情報の損失なしに変換されることができるかどうかを指し示します。
- dataUsingEncoding:
Returns an NSData object containing a representation of the receiver encoded using a given encoding. あるNSDataオブジェクトを返します、与えられた符号化を使って符号化されるレシーバの表現を含んでいます。
description
This NSString object. このNSStringオブジェクト。
fastestEncoding
The fastest encoding to which the receiver may be converted without loss of information. レシーバが情報の損失なしに変換されるであろう最速の符号化。
smallestEncoding
The smallest encoding to which the receiver can be converted without loss of information. レシーバが情報の損失無しに変換できる最小の符号化を返します。
NSStringEncoding
The following constants are provided by NSString as possible string encodings. 以下の定数は、NSStringによって可能な文字列符号化として提供されます。
NSStringEncodingDetectionOptionsKey
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が文字列をある与えられた符号化で表せない、または文字列をプロパティリストであると構文解析するならば引き起こされる例外の名前を定義します。