var style: PersonNameComponentsFormatter.Style
var isPhonetic : Bool
false
by default.
あるブール値、それはレシーバが名前構成要素の発音に関する表現のみを使うべきかどうかを指定します。省略時ではfalse
。
Availability 有効性
Technology
class PersonNameComponentsFormatter : Formatter
Each locale has its own set of rules and conventions for how personal names are structured and represented. These rules vary widely across different locales in a several ways, including the sort and display order of given and family names, the use of salutations and honorifics, and other concerns related to the grammar, spelling, punctuation, and formatting. About the only thing that is consistent across all locales is that personal names are significant and meaningful. For this reason, names deserve careful and respectful treatment—perhaps more than any other kind of information your app interacts with. 各ロケールは、それ独自のひと揃いの規則と、どのように個人名が構造化され表現されるかに対する慣行を持ちます。それら規則は、異なるロケールに移れば幾つかの点で大きく変動します、それは名と家族名のソートと表示の順序、あいさつ句と敬称の使用、そして文法、綴り方、句読点、および書式設定に関するその他の懸念材料を含んで余す。ほぽ全ロケールに渡って首尾一貫する唯一の事柄は、個人名は重要で意味があるということです。この理由のために、名前は注意深く敬意を持った扱いに値します — おそらくあなたのアプリが交流する他のどんな種類の情報よりも。
Formatters can be configured to represent names in a variety of styles, which are described in detail below. フォーマッタは、名前をさまざまなスタイルで表すように構成設定されることができます、それは詳細に下で記述されます。
Abbreviated (Person
)
When determining how to represent a name in a particular style, a formatter takes a number of factors into consideration, in order of priority: 名前を特定のスタイルにおいてどのように表すかを決定している場合、フォーマッタはいくつかの因子を、以下の優先度の順で考慮に入れます:
Script derived behaviors Scripts may specify a strict sort or display order of given and family names, and the availability of styles. 書体から引き出される挙動 書体は、名および苗字の厳密ソートまたは表示順、そしてスタイルの利用可能性を指定するかもしれません。
User specified preferences Users can enable and configure the display of short names, as well as whether or not to display nicknames when available. Users can also override the default sort and display order of given and family names for their current locale. ユーザ指定の環境設定 ユーザは短い名前の表示を可能におよび構成設定できます、利用可能な場合にニックネームを表示するかどうかだけでなく。ユーザはまた、名および苗字のそれらの現在のロケールに対する省略時のソートおよび表示の順序をオーバーライドできます。
Locale derived defaults Locales specify a default sort and display order for given and family names. ロケールから引き出される初期状態 ロケールは名と苗字に対する省略時のソートおよび表示の順序を指定します。
Developer specified configuration The style property value set for the NSPerson
object.
開発者指定の構成設定 NSPerson
オブジェクトに設定されるスタイルプロパティ値。
When the behavior specified in one factor conflicts with any other factors, the behavior specified by the factor with the most precedence is used.
ある因子において指定された挙動が何か他の因子と衝突する場合、最も高い優先度をもつ因子によって指定された挙動が使用されます。
For example, the U.S. English (en-US
) locale specifies that names be displayed in “given name followed by the family name” (for example,“John Appleseed”). This behavior would be overridden if the user changed their system preferences to have names displayed as family name followed by given name (for example, “Appleseed, John”), because user-specified preferences take precedence over locale-derived defaults. Furthermore, if the name to be formatted were Japanese (for example, given name: “泰夫”, family name: “木田”), the behavior derived for the name’s script (CJK, for Chinese, Japanese, and Korean languages) would take precedence over any locale-derived defaults or user-specified preferences to have the name displayed as family name followed by given name (for example, “木田 泰夫”).
この挙動は、もしユーザが彼らのシステム環境設定を変更して名前の表示を苗字に名が続くようにしたならばオーバーライドされるでしょう(例えば、“Appleseed, John”)、なぜならユーザ指定の環境設定はロケール由来の初期設定に優先するからです。さらに、書式設定される名前が日本語だったならば(例えば、名:“泰夫”、苗字:“木田”)、名前のもつ書体(中国語、日本語、そして朝鮮語に対するCJK)に対して導き出される挙動は、あらゆるロケール由来の初期設定またはユーザ指定の環境設定より優先して名前の表示を苗字に名が続くようにするでしょう(例えば、“木田 泰夫”)。
These considerations extend to the availability of certain formatter styles as well. Because developer-specified configurations have the lowest precedence in determining behavior, the value set for the formatter’s style property can be invalidated if it’s not supported for the locale, user preferences, or script. If the specified style is not available, the next longest valid style is used. For example, a name in Arabic script (for example, “أحمد الراجحي”) does not support the Abbreviated style, so the Short style is used instead. これらの配慮は、特定のフォーマッタスタイルの利用可能性にも同様に及びます。開発者指定の構成設定が最も低い優先度を挙動の決定において持つことから、フォーマッタのもつスタイルプロパティに対する値ひとそろいは、それがロケール、ユーザ環境設定、または書体にサポートされないならば無効にされます。指定されたスタイルが利用可能でないならば、次に長い有効なスタイルが使われます。例えば、Arabic書体におけるある名前(例えば、“أحمد الراجحي”)は、「Abbreviated(省略)」スタイルをサポートしません、それで「Short(短い)」スタイルが代わりに使われます。
Note 注意
A name that contains more than one script (for example, given name: “John”, family name: “王”) is detected to have “Unknown” script, which has its own set of behaviors and characteristics. 1つ以上の書体を含む名前(例えば、名:“John”、苗字:“王”)は、それ独自のひとそろいの挙動と特徴を持つ、“Unknown(不明)” 書体を持つと検知されます。
NSPerson
can be configured to format names in the following styles:
NSPerson
は、以下のスタイルで名前を書式設定するように構成設定されることができます:
PersonNameComponentsFormatter.Style.default
The minimally necessary features for differentiation in a casual setting. Equivalent to Person
.
ふだんの設定における識別のために最小限必要な機能性。Person
に相当します。
PersonNameComponentsFormatter.Style.short
Relies on user preferences and language defaults to display shortened form appropriate for display in space-constrained settings. ユーザ環境設定と言語初期値を当てにして、空間抑制設定における表示に適切な短縮形を表示します。
PersonNameComponentsFormatter.Style.long
The fully qualified name complete with all known components. 全ての既知の構成要素が備わっている完全修飾名。
PersonNameComponentsFormatter.Style.abbreviated
The maximally abbreviated form of a name. ある名前の最大限に省略された形式。
|
|
|
|
|
|
|
---|---|---|---|---|---|---|
Arabic
|
.د |
أحمد |
محمدالمصري |
|||
Chinese
|
物理学博士 |
振宁 |
杨 |
先生 |
||
English
|
Dr. |
Jonathan |
Maple |
Appleseed |
Esq. |
Johnny |
French
|
Père |
Jean-Philippe |
de Zélicourt |
JP |
||
German
|
Dr. med. |
Max |
Mustermann |
junior, M.A. |
||
Hindi
|
डॉ. |
रिय |
साहिल |
|||
Japanese
|
泰夫 |
木田 |
先生 |
|||
Spanish
|
Dr. |
José Ramiro |
Martín González de Rivera |
júnior, PhD |
Ramiro |
|
Thai
|
ฯพณฯ |
สมชาย |
ปีเตอร์ |
รัตนเรืองรองบวรทิพย์ |
The Default, or Medium, style presents names in a way that is suitable for most contexts. It uses the given and family names, as well as a nickname, if provided and enabled by the user in System Preferences. Default(初期状態)、またはMedium(中)スタイルは、名前を、最も文脈に適する方法で提示します。それは名および苗字を使います、それだけでなくニックネームも、もしユーザによってシステム環境設定において提供されて利用可能にされるならば。
Default style |
|
---|---|
Arabic (ar-SA) |
أحمد محمﺩﺍلمصﺭﻱ |
Chinese (zh-Hans) |
杨振宁 |
English (en-US) |
Jonathan Appleseed |
French (fr-FR) |
Jean-Philippe de Zélicourt |
German (de-DE) |
Max Mustermann |
Hindi (hi-IN) |
रिय साहिल |
Japanese (ja-JP) |
木田泰夫 |
Spanish (es-ES) |
José Ramiro Martín González de Rivera |
Thai (th-TH) |
สมชาย รัตนเรืองรอง บวรทิพย์ |
The Short style offers an alternative display method for names whose default representation may exceed a certain length constraint. It is only available if the user has enabled “Short Names” in System Preferences, and only for names with a script that supports Short style. Otherwise, a formatter configured to display with Short style is displayed with Medium style instead. Short(短)スタイルは、ある代替の表示方法を、省略時の表現が特定の長さ制約を超えるかもしれない名前に対して提案します。それは、ユーザが “Short Names” をシステム環境設定において有効にする場合にのみ、そしてShortスタイルをサポートする書体を持つ名前に対してのみ利用可能です。そうでなければ、Shortスタイルで表示するよう構成設定されるフォーマッタは代わりにMediumスタイルで表示されます。
If a user has enabled the use of short names, the user can choose from one of four variations: あるユーザがショートネームの利用を可能にするならば、そのユーザは4つの異体の1つから選べます:
Given Name - Family Initial 名 - 姓頭文字
Family Name - Given Initial 姓 - 名頭文字
Given Name Only 名だけ
Family Name Only 姓だけ
Short style is not available for names in CJK script and is restricted to Given Name Only or Family Name Only for names in Arabic or Devanagari script. If the specified Short style is unavailable, the Medium style is used instead. Shortスタイルは、CJK書体での名前に対しては利用可能でありません、そしてアラビア語またはデーヴァナーガリー書体での名前に対しては「名のみ」または「姓のみ」に制限されます。指定されたShortスタイルが利用可能でないならば、Mediumスタイルが代わりに使われます。
Given Name - Family Initial 名 - 姓頭文字 |
Family Name - Given Initial 姓 - 名頭文字 |
Given Name Only 名だけ |
Family Name Only 姓だけ |
|
---|---|---|---|---|
Arabic (ar-SA) |
N/A |
N/A |
أحمد |
محمﺩﺍلمصﺭﻱ |
Chinese (zh-Hans) |
N/A |
N/A |
N/A |
N/A |
English (en-US) |
Jonathan A |
J Appleseed |
Jonathan |
Appleseed |
French (fr-FR) |
Jean-Philippe d |
J de Zélicourt |
Jean-Philippe |
de Zélicourt |
German (de-DE) |
Max M |
M Mustermann |
Max |
Mustermann |
Hindi (hi-IN) |
N/A |
N/A |
रिय |
साहिल |
Japanese (ja-JP) |
N/A |
N/A |
N/A |
N/A |
Spanish (es-ES) |
José Ramiro M |
J Martín González de Rivera |
José Ramiro |
Martín González de Rivera |
Thai (th-TH) |
สมชาย ร |
ส รัตนเรืองรองบวรทิพย์ |
สมชาย |
รัตนเรืองรองบวรทิพย์ |
Important 重要
NSPerson
does not currently account for prepositional particles. Representations using the Short style that specify a family name initial naively use the first letter unit of the particle as the initial.
NSPerson
は、現在は冠数詞について理解をしません。Shortスタイルを使っている表現で姓頭文字を指定するものは、愚直に不変化詞の最初のレターユニット(表音文字単位)を頭文字として使います。
The Long style provides the most explicit representation of names. It uses all available name components, with the exception of nickname. Long(長)スタイルは、名前の最も率直な表現を提供します。それはすべての利用可能な名前構成要素を使います、ニックネームを除いて。
Long style |
|
---|---|
Arabic (ar-SA) |
ﺩ. أحمد محمﺩﺍلمصﺭﻱ |
Chinese (zh-Hans) |
物理学博士杨振宁先生 |
English (en-US) |
Dr. Jonathan Maple Appleseed Esq. |
French (fr-FR) |
Père Jean-Philippe de Zélicourt |
German (de-DE) |
Dr. med. Max Mustermann junior, M.A. |
Hindi (hi-IN) |
डॉ. रिय साहिल |
Japanese (ja-JP) |
木田泰夫先生 |
Spanish (es-ES) |
Dr. José Ramiro Martín González de Rivera júnior, PhD |
Thai (th-TH) |
ฯพณฯ สมชาย ปีเตอร์ รัตนเรืองรอง บวรทิพย์ |
The Abbreviated style offers the most compact representation of names, similar to a monogram. Abbreviated(省略)スタイルは、モノグラムのような、名前の最も簡潔な表現を提案します。
Abbreviated style is supported for names in several scripts, with the following general characteristics: Abbreviatedスタイルは、いくつかの書体での名前によってサポートされます、以下の一般的な特徴を持ちます:
For names in Cyrillic, Greek, or Latin script, the first characters of given
, middle
, and family
may be used.
キリル語、ギリシャ語、またはラテン語書体での名前に対して、given
、middle
、そしてfamily
の最初の表意文字が使われるかもしれません。
For names in Chinese or Japanese script, family
may be used. If family
is too long, or if the family name is nil
, the Short or Medium style may be used instead.
中国語または日本語書体での名前に対して、family
が使われるかもしれません。family
が長すぎるならば、または姓がnil
ならば、ShortまたはMediumスタイルが代わりに使われるかもしれません。
For names in Korean script, given
may be used. If given
is too long, the first character of given
may be used. If given
is nil
, the family
may be used instead.
朝鮮語書体での名前に対して、given
が使われるかもしれません。given
が長すぎるならば、given
の最初の表意文字が使われるかもしれません。given
がnil
ならば、family
が代わりに使われるかもしれません。
For names in Bengali, Devanagari, Gujarati, Gurmukhi, Kannada, Malayalam, Oriya, Sinhala, Tamil, Telugu, Tibetan, or Thai script, the first character of given
may be used. If given
is nil
, the first character of family
may be used instead.
ベンガル語、デーヴァナーガリー、グジャラート語、グルムキー文字、カンナダ語、マラヤーラム語、オリヤー語、シンハラ語、タミル語、テルグ語、チベット語、またはタイ語書体での名前に対して、given
の最初の表意文字が使われるかもしれません。given
がnil
ならば、family
の最初の表意文字が代わりに使われるかもしれません。
For names that contain more than one script, the abbreviated style may use the family
, given
, or the first characters of given
and/or family
.
1つ以上の書体を含む名前に対して、省略されたスタイルはfamily
、given
を、またはgiven
および/またはfamily
の最初の表意文字を使うかもしれません。
If the Abbreviated style is unavailable, the Short style is used instead—unless that too is unsupported, in which case the Medium style is used instead. Abbreviatedスタイルが利用可能でないならば、Shortスタイルが代わりに使われます — それがまたサポートされない場合を除いて、その場合にはMediumスタイルが代わりに使われます。
Abbreviated style |
|
---|---|
Arabic (ar-SA) |
N/A |
Chinese (zh-Hans) |
杨 |
English (en-US) |
JMA |
French (fr-FR) |
Jd |
German (de-DE) |
MM |
Hindi (hi-IN) |
मि |
Japanese (ja-JP) |
木田 |
Spanish (es-ES) |
JM |
Thai (th-TH) |
ส |
Important 重要
NSPerson
doesn’t currently account for prepositional particles or compound names. Representations using the Abbreviated style uses the first letter unit of each name component, regardless.
NSPerson
は、現在は冠数詞または複合名について理解をしません。Abbreviatedスタイルを使っている表現は、おかまいなしに、各名前構成要素の最初の表音文字単位を使います。
var style: PersonNameComponentsFormatter.Style
var isPhonetic : Bool
false
by default.
あるブール値、それはレシーバが名前構成要素の発音に関する表現のみを使うべきかどうかを指定します。省略時ではfalse
。
class func localizedString (from: PersonNameComponents, style: PersonNameComponentsFormatter.Style, options: PersonNameComponentsFormatter.Options) -> String
NSPersonNameComponents
object using the provided style and options.
与えられたNSPersonNameComponents
オブジェクトに対して書式設定される文字列を返します、提供されたスタイルとオブジェクトを使います。
func string(from: PersonNameComponents) -> String
NSPersonNameComponents
object.
与えられたNSPersonNameComponents
オブジェクトに対して書式設定された文字列を返します。
func annotatedString (from: PersonNameComponents) -> NSAttributedString
NSPersonNameComponents
object, with attribute annotations for each component.
ある書式設定された属性付き文字列を、ある与えられたNSPersonNameComponents
オブジェクトに対して返します、各構成要素に対して属性注釈をもちます。
func personNameComponents (from: String) -> PersonNameComponents?
func getObjectValue (AutoreleasingUnsafeMutablePointer<AnyObject?>?, for: String, errorDescription : AutoreleasingUnsafeMutablePointer<NSString?>?) -> Bool
annotatedString(from:)
method
この定数は、annotatedString(from:)
メソッドによって返される属性付き文字列の中の個人名構成要素属性に対するキーとして使われます。
annotatedString(from:)
method.
これらの定数は、annotatedString(from:)
メソッドによって返される属性付き文字列の個々の構成要素を識別するために使われます。
struct PersonNameComponents