---
title: "CFStringGetSurrogatePairForLongCharacter(_:_:)"
framework: corefoundation
role: symbol
role_heading: Function
path: "corefoundation/cfstringgetsurrogatepairforlongcharacter(_:_:)"
---

# CFStringGetSurrogatePairForLongCharacter(_:_:)

Maps a given UTF-32 character to a pair of UTF-16 surrogate characters.

## Declaration

```swift
func CFStringGetSurrogatePairForLongCharacter(_ character: UTF32Char, _ surrogates: UnsafeMutablePointer<UniChar>!) -> Bool
```

## Parameters

- `character`: A UTF-32 character.
- `surrogates`: A buffer to contain the returned surrogate pair. The buffer must have space for at least 2 UTF-16 characters.

## Return Value

Return Value true if character is mapped to a surrogate pair, otherwise false.

## See Also

### Managing Surrogates

- [CFStringGetLongCharacterForSurrogatePair(_:_:)](corefoundation/cfstringgetlongcharacterforsurrogatepair(_:_:).md)
- [CFStringIsSurrogateHighCharacter(_:)](corefoundation/cfstringissurrogatehighcharacter(_:).md)
- [CFStringIsSurrogateLowCharacter(_:)](corefoundation/cfstringissurrogatelowcharacter(_:).md)