<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macCatalyst: 9.0.0 -",
    "macOS: 10.11.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/PersonNameComponents",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "s:10Foundation20PersonNameComponentsV"
  },
  "title" : "PersonNameComponents"
}
-->

# PersonNameComponents

The separate parts of a person’s name, allowing locale-aware formatting.

```
struct PersonNameComponents
```

## Topics

### Creating Person Name Components

[`init()`](/documentation/Foundation/PersonNameComponents/init())

Initializes a new person name components structure.

### Accessing Person Name Components

[`namePrefix`](/documentation/Foundation/PersonNameComponents/namePrefix)

The portion of a name’s full form of address that precedes the name itself.

[`givenName`](/documentation/Foundation/PersonNameComponents/givenName)

Name bestowed upon an individual to differentiate them from other members of a group that share a family name.

[`middleName`](/documentation/Foundation/PersonNameComponents/middleName)

Secondary name bestowed upon an individual to differentiate them from others that have the same given name.

[`familyName`](/documentation/Foundation/PersonNameComponents/familyName)

Name bestowed upon an individual to denote membership in a group or family.

[`nameSuffix`](/documentation/Foundation/PersonNameComponents/nameSuffix)

The portion of a name’s full form of address that follows the name itself.

[`nickname`](/documentation/Foundation/PersonNameComponents/nickname)

Name substituted for the purposes of familiarity.

[`phoneticRepresentation`](/documentation/Foundation/PersonNameComponents/phoneticRepresentation)

The phonetic representation name components of the receiver.

### Formatting Person Name Components

[`formatted()`](/documentation/Foundation/PersonNameComponents/formatted())

Generates a locale-aware string representation of an instance of person name components using the default format style.

[`formatted(_:)`](/documentation/Foundation/PersonNameComponents/formatted(_:))

Generates a locale-aware string representation of an instance of person name components using the provided format style.

[`PersonNameComponents.FormatStyle`](/documentation/Foundation/PersonNameComponents/FormatStyle)

A type used to format a person’s name with a style appropriate for the given locale.

### Using Reference Types

[`NSPersonNameComponents`](/documentation/Foundation/NSPersonNameComponents)

An object that manages the separate parts of a person’s name to allow locale-aware formatting.


---

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)