Initializer

init(format: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オブジェクトを返します、与えられた書式設定文字列を、それへと残りの引数値が指定ロケール情報に従って置き換えられるあるテンプレートとして使うことによって初期化されます。このメソッドは、可変長引数関数内から呼び出されるためのものです、そこでは引数リストが利用可能です。

Declaration 宣言 

convenience init(format: String, 
          locale: Any?, 
       arguments argList: CVaListPointer)

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ではいけません。

locale

An NSLocale object specifying the locale to use. To use the current locale (specified by user preferences), pass [NSLocale current]. To use the system locale, pass nil. あるNSLocaleオブジェクト、使用するロケールを指定します。現在のロケール（ユーザ環境設定で指定される）を使うには、[NSLocale current] を渡してください。システムロケールを使うには、nilを渡してください。

For legacy support, this may be an instance of NSDictionary containing locale information. レガシーサポートのために、これはロケール情報を含んでいるNSDictionaryのインスタンスであるかもしれません。

argList

A list of arguments to substitute into format. formatへの代わりをする引数のリスト。

Return Value 戻り値

An NSString object initialized by using format as a template into which values in argList are substituted according the locale information in locale. The returned object may be different from the original receiver. あるNSStringオブジェクト、formatをそれへとargListの中の値がlocaleの中のロケール情報に従って代用されるテンプレートとして使って初期化されます。返されるオブジェクトは、元のレシーバと異なるかもしれません。

Discussion 議論

The following Objective-C code fragment illustrates how to create a string from myArgs, which is derived from a string object with the value “Cost:” and an int with the value 32: 以下のObjective-Cコード断片は、myArgsから文字列を作成する方法を図示します、それは値 “Cost:” を持つ文字列オブジェクトと値32を持つintから引き出されます： 


va_list myArgs;
 
NSString *myString = [[NSString alloc] initWithFormat:@"%@: %d\n"
                                               locale:[NSLocale currentLocale]
                                            arguments:myArgs];

The resulting string has the value “Cost: 32\n”. 結果文字列は、値 “Cost: 32\n” を持ちます。

See String Programming Guide for more information. 文字列操作プログラミングガイドを更なる情報として見てください。

See Also 参照

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

init()
Returns an initialized NSString object that contains no characters. 初期化されたNSStringオブジェクトを返します、それは文字を含みません。
init?(bytes: UnsafeRawPointer, length: Int, encoding: UInt)
Returns an initialized NSString object containing a given number of bytes from a given buffer of bytes interpreted in a given encoding. 初期化されたNSStringオブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトの、ある与えられたバッファから含みます。
init?(bytesNoCopy: UnsafeMutableRawPointer, length: Int, encoding: UInt, freeWhenDone: Bool)
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オブジェクトを返します、それはある与えられた数のバイトを、ある与えられた符号化で解釈されるバイトのある与えられたバッファから含みます、そして任意にバッファを解放します。
init(characters: UnsafePointer<unichar>, length: Int)
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配列から含んでいます。
init(charactersNoCopy: UnsafeMutablePointer<unichar>, length: Int, freeWhenDone: Bool)
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配列から含んでいます。
init(string: String)
Returns an NSString object initialized by copying the characters from another given string. NSStringオブジェクトを返します、別の与えられた文字列から文字をコピーすることによって初期化されます。
init?(cString: UnsafePointer<CChar>, encoding: UInt)
Returns an NSString object initialized using the characters in a given C array, interpreted according to a given encoding. NSStringオブジェクトを返します、与えられたC配列の中の文字を使って初期化されます、与えられた符号化によって解釈されます。
init?(utf8String: UnsafePointer<CChar>)
Returns an NSString object initialized by copying the characters from a given C array of UTF8-encoded bytes. NSStringオブジェクトを返します、UTF8符号化されたバイトからなる与えられたC配列から文字をコピーすることによって初期化されます。
init(format: String, arguments: CVaListPointer)
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オブジェクトを返します、与えられた書式設定文字列をテンプレートとして使って、それへと残りの引数値が何らローカライズなしに置き換えられることによって初期化されます。
init?(data: Data, encoding: UInt)
Returns an NSString object initialized by converting given data into UTF-16 code units using a given encoding. NSStringオブジェクトを返します、与えられたデータをUTFー16コード単位へとある与えられた符号化を使って変換することによって初期化されます。
class func localizedUserNotificationString(forKey: String, arguments: [Any]?) -> String
Returns a localized string intended for display in a notification alert. ローカライズされた文字列を返します、通知アラートにおいて表示されるのを意図されます。
class func localizedStringWithFormat(NSString, CVarArg...) -> Self
typealias unichar
Type for UTF-16 code units. UTF-16コード単位に対する型。