---
title: "UCDisposeCollator(_:)"
framework: coreservices
role: symbol
role_heading: Function
path: coreservices/1390435-ucdisposecollator
---

# UCDisposeCollator(_:)

Disposes a collator object.

## Declaration

```swift
func UCDisposeCollator(_ collatorRef: UnsafeMutablePointer<CollatorRef?>!) -> OSStatus
```

## Parameters

- `collatorRef`: A reference to a valid collator object. The UCDisposeCollator function sets *collatorRef to NULL.

## Return Value

Return Value A result code.

## Discussion

Discussion To perform Unicode string comparison, you must supply locale and collation specifications to a collation function such as  UCCompareText(_:_:_:_:_:_:_:). You provide this information by means of a collator object, created via the function  UCCreateCollator(_:_:_:_:). When finished with the collator object, you should dispose of it using the function UCDisposeCollator.

## See Also

### Comparing Unicode Strings

- [UCCreateCollator(_:_:_:_:)](coreservices/1390403-uccreatecollator.md)
- [UCCompareText(_:_:_:_:_:_:_:)](coreservices/1390642-uccomparetext.md)
- [UCGetCollationKey(_:_:_:_:_:_:)](coreservices/1390468-ucgetcollationkey.md)
- [UCCompareCollationKeys(_:_:_:_:_:_:)](coreservices/1390378-uccomparecollationkeys.md)
- [UCCompareTextDefault(_:_:_:_:_:_:_:)](coreservices/1390472-uccomparetextdefault.md)
- [UCCompareTextNoLocale(_:_:_:_:_:_:_:)](coreservices/1390513-uccomparetextnolocale.md)