Type Method 型メソッド

localizedStringWithFormat:

Returns a string created by using a given format string as a template into which the remaining argument values are substituted according to the current locale. 与えられた書式設定文字列を、それへと残りの引数値が現在のロケールに従って置き換えられるテンプレートとして使うことで作成される文字列を返します。

Declaration 宣言 

+ (instancetype)localizedStringWithFormat:(NSString *)format, ...;

Parameters パラメータ

format

A format string. See Formatting String Objects for examples of how to use this method, and String Format Specifiers for a list of format specifiers. This value must not be nil. 書式設定文字列。Formatting String Objectsをこのメソッドを使う方法の例として、String Format Specifiersを書式設定指定子のリストとして見てください。この値は、nilではいけません。

Raises an NSInvalidArgumentException if format is nil. NSInvalidArgumentExceptionを引き起こします、もしformatがnilならば。

...

A comma-separated list of arguments to substitute into format. formatへと置換することになる、引数のコンマ区切りのリスト。

Return Value 戻り値

A string created by using format as a template into which the following argument values are substituted according to the formatting information in the current locale. formatを、それへとこの後に続く引数値が現在のロケールにおける書式設定情報に従って置き換えられるテンプレートとして使うことによって作成される文字列。

Discussion 議論

This method is equivalent to using initWithFormat:locale: and passing the current locale as the locale argument. このメソッドは、initWithFormat:locale:を使ってそして現在のロケールをロケール引数として渡すことに等しいです。

As an example of formatting, this method replaces the decimal according to the locale in %f and %d substitutions, and calls descriptionWithLocale: instead of description where necessary. 書式設定の例として、このメソッドは10進数を%fと%d置換に従って置き換えます、そしてdescriptionWithLocale:をdescriptionの代わりに必要に応じて呼び出します。

This code excerpt creates a string from another string and a float: このコード抜粋は、ある文字列を別の文字列とfloatから作成します： 


NSString *myString = [NSString localizedStringWithFormat:@"%@:  %f\n", @"Cost", 1234.56];

The resulting string has the value “Cost: 1234.560000\n” if the locale is en_US, and “Cost: 1234,560000\n” if the locale is fr_FR. 結果文字列は、値 “Cost: 1234.560000\n” をもしロケールがen_USであるならば、そして “Cost: 1234,560000\n” をロケールがfr_FRであるならば、持ちます。

See Formatting String Objects for more information. Formatting String Objectsを詳細として見てください。

See Also 参照

Creating and Initializing Strings 文字列の作成と初期化

+ string
Returns an empty string. 空の文字列を返します。
- init
Returns an initialized NSString object that contains no characters. 初期化されたNSStringオブジェクトを返します、それは文字を含みません。
- initWithBytes:length:encoding:
Returns an initialized NSString object containing a given number of bytes from a given buffer of bytes interpreted in a given encoding. 初期化されたNSStringオブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトの、ある与えられたバッファから含みます。
- initWithBytesNoCopy:length:encoding:freeWhenDone:
Returns an initialized NSString object that contains a given number of bytes from a given buffer of bytes interpreted in a given encoding, and optionally frees the buffer. 初期化されたNSStringオブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトのある与えられたバッファから含みます、そして任意にバッファを解放します。
- initWithCharacters:length:
Returns an initialized NSString object that contains a given number of characters from a given C array of UTF-16 code units. 初期化されたNSStringオブジェクトを返します、それは与えられた数の文字を、UTF-16コード単位からなる与えられたC配列から含んでいます。
- initWithCharactersNoCopy:length:freeWhenDone:
Returns an initialized NSString object that contains a given number of characters from a given C array of UTF-16 code units. 初期化されたNSStringオブジェクトを返します、それは与えられた数の文字を、UTF-16コード単位からなる与えられたC配列から含んでいます。
- initWithString:
Returns an NSString object initialized by copying the characters from another given string. NSStringオブジェクトを返します、別の与えられた文字列から文字をコピーすることによって初期化されます。
- initWithCString:encoding:
Returns an NSString object initialized using the characters in a given C array, interpreted according to a given encoding. NSStringオブジェクトを返します、与えられたC配列の中の文字を使って初期化されます、与えられた符号化によって解釈されます。
- initWithUTF8String:
Returns an NSString object initialized by copying the characters from a given C array of UTF8-encoded bytes. NSStringオブジェクトを返します、UTF8符号化されたバイトからなる与えられたC配列から文字をコピーすることによって初期化されます。
- initWithFormat:
Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted. 与えられた書式設定文字列を、それへと残りの引数値が置き換えられるテンプレートとして使うことによって初期化されるNSStringオブジェクトを返します。
- initWithFormat:arguments:
Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted without any localization. あるNSStringオブジェクトを返します、与えられた書式設定文字列をテンプレートとして使って、それへと残りの引数値が何らローカライズなしに置き換えられることによって初期化されます。
- initWithFormat:locale:
Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted according to given locale. NSStringオブジェクトを返します、与えられた書式設定文字列を、それへと残りの引数値がある与えられたロケールに従って置き換えられるテンプレートとして使うことによって初期化されます。
- initWithFormat:locale:arguments:
Returns an NSString object initialized by using a given format string as a template into which the remaining argument values are substituted according to given locale information. This method is meant to be called from within a variadic function, where the argument list will be available. NSStringオブジェクトを返します、与えられた書式設定文字列を、それへと残りの引数値が指定ロケール情報に従って置き換えられるあるテンプレートとして使うことによって初期化されます。このメソッドは、可変長引数関数内から呼び出されるためのものです、そこでは引数リストが利用可能です。
- initWithData:encoding:
Returns an NSString object initialized by converting given data into UTF-16 code units using a given encoding. NSStringオブジェクトを返します、与えられたデータをUTFー16コード単位へとある与えられた符号化を使って変換することによって初期化されます。
+ stringWithFormat:
Returns a string created by using a given format string as a template into which the remaining argument values are substituted. 与えられた書式設定文字列を、それへと残りの引数値が置き換えられるテンプレートとして使うことで作成される文字列を返します。
+ localizedUserNotificationStringForKey:arguments:
Returns a localized string intended for display in a notification alert. ローカライズされた文字列を返します、通知アラートにおいて表示されるのを意図されます。
+ stringWithCharacters:length:
Returns a string containing a given number of characters taken from a given C array of UTF-16 code units. UTF-16コード単位からなるある与えられたC配列から取られる与えられた数の文字を含んでいる文字列を返します。
+ stringWithString:
Returns a string created by copying the characters from another given string. 別の与えられた文字列から文字をコピーすることによって作成される文字列を返します。
+ stringWithCString:encoding:
Returns a string containing the bytes in a given C array, interpreted according to a given encoding. 与えられたCはい列の中のバイトを含んでいる文字列を返します、与えられた符号化に従って解釈されます。
+ stringWithUTF8String:
Returns a string created by copying the data from a given C array of UTF8-encoded bytes. UTF8符号化されたバイトからなるある与えられたC配列からデータをコピーすることによって作成される文字列を返します。
unichar
Type for UTF-16 code units. UTF-16コード単位に対する型。