---
title: PersonNameComponents
framework: foundation
role: symbol
role_heading: Structure
path: foundation/personnamecomponents
---

# PersonNameComponents

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

## Declaration

```swift
struct PersonNameComponents
```

## Topics

### Creating Person Name Components

- [init()](foundation/personnamecomponents/init().md)

### Accessing Person Name Components

- [namePrefix](foundation/personnamecomponents/nameprefix.md)
- [givenName](foundation/personnamecomponents/givenname.md)
- [middleName](foundation/personnamecomponents/middlename.md)
- [familyName](foundation/personnamecomponents/familyname.md)
- [nameSuffix](foundation/personnamecomponents/namesuffix.md)
- [nickname](foundation/personnamecomponents/nickname.md)
- [phoneticRepresentation](foundation/personnamecomponents/phoneticrepresentation.md)

### Formatting Person Name Components

- [formatted()](foundation/personnamecomponents/formatted().md)
- [formatted(_:)](foundation/personnamecomponents/formatted(_:).md)
- [PersonNameComponents.FormatStyle](foundation/personnamecomponents/formatstyle.md)

### Using Reference Types

- [NSPersonNameComponents](foundation/nspersonnamecomponents.md)

### Structures

- [PersonNameComponents.AttributedStyle](foundation/personnamecomponents/attributedstyle.md)
- [PersonNameComponents.ParseStrategy](foundation/personnamecomponents/parsestrategy.md)

### Initializers

- [init(_:)](foundation/personnamecomponents/init(_:).md)
- [init(_:strategy:)](foundation/personnamecomponents/init(_:strategy:).md)
- [init(namePrefix:givenName:middleName:familyName:nameSuffix:nickname:phoneticRepresentation:)](foundation/personnamecomponents/init(nameprefix:givenname:middlename:familyname:namesuffix:nickname:phoneticrepresentation:).md)

### Type Aliases

- [PersonNameComponents.Specification](foundation/personnamecomponents/specification.md)
- [PersonNameComponents.UnwrappedType](foundation/personnamecomponents/unwrappedtype.md)
- [PersonNameComponents.ValueType](foundation/personnamecomponents/valuetype.md)

### Type Properties

- [defaultResolverSpecification](foundation/personnamecomponents/defaultresolverspecification.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomLocalizedStringResourceConvertible](foundation/customlocalizedstringresourceconvertible.md)
- [CustomReflectable](swift/customreflectable.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Decodable](swift/decodable.md)
- [DisplayRepresentable](appintents/displayrepresentable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)
- [InstanceDisplayRepresentable](appintents/instancedisplayrepresentable.md)
- [IntentValueConvertible](appintents/intentvalueconvertible.md)
- [IntentValueExpressing](appintents/intentvalueexpressing.md)
- [ReferenceConvertible](foundation/referenceconvertible.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)
- [TypeDisplayRepresentable](appintents/typedisplayrepresentable.md)

## See Also

### Names

- [PersonNameComponentsFormatter](foundation/personnamecomponentsformatter.md)