init(_:)

Declaration

init(_ value: String) throws

Parameters

• value:

  A string to parse into name components.

Discussion

This initializer 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.

• The format style parses names with a single delimited component 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.

• The format style may parse names in inverted Latin script into components in a different order than they appear. Inverted names in CJK script won’t typically produce the correct results.

• 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.

• The format style ignores text between parentheses or brackets, as well as extraneous characters in names.

See Also

Parsing Person Name Components

• init(_:strategy:)