---
title: "CTFontDescriptorMatchFontDescriptorsWithProgressHandler(_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontdescriptormatchfontdescriptorswithprogresshandler(_:_:_:)"
---

# CTFontDescriptorMatchFontDescriptorsWithProgressHandler(_:_:_:)

Matches font descriptors and tracks progress with a progress handler.

## Declaration

```swift
func CTFontDescriptorMatchFontDescriptorsWithProgressHandler(_ descriptors: CFArray, _ mandatoryAttributes: CFSet?, _ progressBlock: @escaping CTFontDescriptorProgressHandler) -> Bool
```

## Parameters

- `descriptors`: An array of descriptors to process.
- `mandatoryAttributes`: A set of attributes to match.
- `progressBlock`: A callback block that indicates the progress of the matching process. Return doc://com.apple.documentation/documentation/Swift/true to continue or doc://com.apple.documentation/documentation/Swift/false to cancel the process. This block is called on a private serial queue.

## Return Value

Return Value false if the system couldn’t start the matching process.

## Discussion

Discussion This function returns immediately, but it can take longer to finish the process. The progressBlock handler tracks the progress.

## See Also

### Functions

- [CTFontManagerCompareFontFamilyNames(_:_:_:)](coretext/ctfontmanagercomparefontfamilynames(_:_:_:).md)
- [CTFontManagerCopyAvailableFontFamilyNames()](coretext/ctfontmanagercopyavailablefontfamilynames().md)
- [CTFontManagerCopyAvailableFontURLs()](coretext/ctfontmanagercopyavailablefonturls().md)
- [CTFontManagerCopyAvailablePostScriptNames()](coretext/ctfontmanagercopyavailablepostscriptnames().md)
- [CTFontManagerCreateFontDescriptorFromData(_:)](coretext/ctfontmanagercreatefontdescriptorfromdata(_:).md)
- [CTFontManagerCreateFontDescriptorsFromURL(_:)](coretext/ctfontmanagercreatefontdescriptorsfromurl(_:).md)
- [CTFontManagerCreateFontRequestRunLoopSource(_:_:)](coretext/ctfontmanagercreatefontrequestrunloopsource(_:_:).md)
- [CTFontManagerEnableFontDescriptors(_:_:)](coretext/ctfontmanagerenablefontdescriptors(_:_:).md)
- [CTFontManagerGetAutoActivationSetting(_:)](coretext/ctfontmanagergetautoactivationsetting(_:).md)
- [CTFontManagerGetScopeForURL(_:)](coretext/ctfontmanagergetscopeforurl(_:).md)
- [CTFontManagerIsSupportedFont(_:)](coretext/ctfontmanagerissupportedfont(_:).md)
- [CTFontManagerRegisterFontsForURL(_:_:_:)](coretext/ctfontmanagerregisterfontsforurl(_:_:_:).md)
- [CTFontManagerRegisterFontsForURLs(_:_:_:)](coretext/ctfontmanagerregisterfontsforurls(_:_:_:).md)
- [CTFontManagerRegisterGraphicsFont(_:_:)](coretext/ctfontmanagerregistergraphicsfont(_:_:).md)
- [CTFontManagerSetAutoActivationSetting(_:_:)](coretext/ctfontmanagersetautoactivationsetting(_:_:).md)