---
title: "attributedString(from:style:defaultAttributes:)"
framework: contacts
role: symbol
role_heading: Type Method
path: "contacts/cncontactformatter/attributedstring(from:style:defaultattributes:)"
---

# attributedString(from:style:defaultAttributes:)

Formats the contact name as an attributed string.

## Declaration

```swift
class func attributedString(from contact: CNContact, style: CNContactFormatterStyle, defaultAttributes attributes: [AnyHashable : Any]? = nil) -> NSAttributedString?
```

## Parameters

- `contact`: The contact whose name is to be formatted.
- `style`: The formatting style to be used for the contact name.
- `attributes`: The default attributes to use. For more information, see doc://com.apple.documentation/documentation/Foundation/Formatter.

## Return Value

Return Value The formatted contact name as an attributed string. Discussion This method behaves similarly to string(from:style:), except that it returns an attributed string. It includes the attribute key CNContactPropertyAttribute, whose attribute values are contact property keys, such as CNContactGivenNameKey. This identifies the name components in the formatted contact name.

## See Also

### Creating a formatted attributed string

- [attributedString(from:defaultAttributes:)](contacts/cncontactformatter/attributedstring(from:defaultattributes:).md)
