<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/PersonNameComponents/init(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "s:10Foundation20PersonNameComponentsVyACSSKcfc"
  },
  "title" : "init(_:)"
}
-->

# init(_:)

Creates a person name components object from a given string.

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

> Important:
> Only names using Latin or CJK scripts are supported.

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.

|String                               |Name prefix|Given name   |Middle name|Family name              |Name suffix|
|-------------------------------------|-----------|-------------|-----------|-------------------------|-----------|
|Thomas Clark                         |           |Thomas       |           |Clark                    |           |
|Thomas Louis Clark                   |           |Thomas       |Louis      |Clark                    |           |
|Tom Louis Appleseed                  |           |Tom Louis    |           |Clark                    |           |
|Thomas L. Appleseed                  |           |Thomas       |L.         |Clark                    |           |
|Dr. Thomas, Esq.                     |Dr.        |Thomas       |           |                         |Esq.       |
|thomas clark                         |           |thomas       |           |clark                    |           |
|Clark, Thomas                        |           |Thomas       |           |Clark                    |           |
|Clark Thomas                         |           |Thomas       |           |Clark                    |           |
|CLARK Thomas                         |           |Thomas       |           |CLARK                    |           |
|Thomas (a.k.a. Tom) Clark 🍎          |           |Thomas       |           |Clark                    |           |
|杨振宁                                  |           |振宁           |           |杨                        |           |
|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|           |

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)