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

personNameComponentsFromString:

Returns a person name components object from a given string. ある与えられた文字列から個人名構成要素オブジェクトを返します。

Declaration 宣言

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

Parameters パラメータ

string

A string that is parsed to create a person name components object. ある文字列、それは個人名構成要素オブジェクトを作成するために構文解析されます。

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. 2つより多い区切られた構成要素をもつラテンでの名前は、真ん中の構成要素をgivenNamemiddleName、または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

See Also 参照

Converting Between Person Name Components and Strings 個人名構成要素と文字列の間で変換する