personNameComponentsFromString:

- (NSPersonNameComponents *)personNameComponentsFromString:(NSString *)string;

Return Value 戻り値

An NSPersonNameComponents object parsing string using the receiver’s format, or nil if no components could be parsed. レシーバのもつ書式設定を使って文字列を構文解析しているNSPersonNameComponentsオブジェクト、または構成要素それらが構文解析されることができなかったならばnil。

Discussion 議論

This method uses a combination of locale rules and heuristics to determine the most likely name components for a particular string representation. Parsing name components from a representation created for an existing name components object may not produce equivalent results. このメソッドは、ローカル規則と発見的手法の組み合わせを使って、特定の文字列表現に対して最もありそうな名前構成要素を決定します。既存の名前構成要素オブジェクトに対して作成されたある表現から名前構成要素を構文解析することは、同等の結果を生成しないかもしれません。

Here are some general rules that describe the name component parsing behavior: ここに名前構成要素構文解析挙動を記述するいくつかの一般的規則があります。

• Names in Latin script have components delimited by whitespace. ラテン書体での名前は、空白によって区切られる構成要素を持ちます。

• Names with a single delimited component are parsed into their most likely name component. 単一の区切られた構成要素をもつ名前は、それの最もありそうな名前構成要素へと構文解析されます。

• Names in Latin script with more than two delimited components may include middle components in the givenName, middleName, or familyName name components. ２つより多い区切られた構成要素をもつラテンでの名前は、真ん中の構成要素をgivenName、middleName、またはfamilyName名前構成要素において含むかもしれません。

• Names in Latin script that are inverted may be parsed into components in a different order than they appear; names in CJK script that are inverted will not typically produce the correct results. 逆にされるラテン書体での名前は、それらが現れるのとは異なる順で構成要素へと構文解析されるかもしれません；逆にされるCJK書体での名前は、概して正しい結果を生成しないでしょう。

• Names in Latin script may use a comma to indicate name inversion. ラテン書体での名前は、名前逆転を指し示すためにコンマを使うかもしれません。

• Names in Latin script have capitalization preserved between string representation and parsed components. ラテン書体での名前は、文字列表現と構文解析された構成要素の間でキャピタライゼーションを保護します。

• Text between parentheses or brackets, as well as extraneous characters in names is ignored. 名前における丸括弧または角括弧の間のテキストは、もちろん余分な文字も、無視されます。

String	namePrefix	givenName	middleName	familyName	nameSuffix
Jonathan Appleseed		Jonathan		Appleseed
Jonathan Paul Appleseed		Jonathan	Paul	Appleseed
John Paul Appleseed		John Paul		Appleseed
Jonathan P. Appleseed		Jonathan	P.	Appleseed
Dr. Jonathan, Esq.	Dr.	Jonathan			Esq.
jonathan appleseed		jonathan		appleseed
Appleseed, Jonathan		Jonathan		Appleseed
Appleseed Jonathan		Jonathan		Appleseed
APPLESEED Jonathan		Jonathan		APPLESEED
Jonathan (a.k.a. Johnny) Appleseed 🍎		Jonathan		Appleseed
杨振宁		振宁		杨
Jean-Philippe de Zélicourt		Jean-Philippe		de Zélicourt
Max Mustermann		Max		Mustermann
木田泰夫		泰夫		木田
José Ramiro Martín González de Rivera		José	Ramiro	Martín González de Rivera