---
title: "init(format:_:)"
framework: clockkit
role: symbol
role_heading: Initializer
path: "clockkit/clktextprovider/init(format:_:)"
---

# init(format:_:)

Creates and returns a text provider built from the specified format string.

## Declaration

```swift
convenience init(format: String, _ args: any CVarArg...)
```

## Parameters

- `format`: A format string to use when building the text provider. To insert content from another text provider into the string, use the %@ placeholder. For more information and examples about the placeholders you can use in this string, see https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/Strings/Articles/FormatStrings.html#//apple_ref/doc/uid/20000943 and https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFStrings/formatSpecifiers.html#//apple_ref/doc/uid/TP40004265. This parameter must not be nil.
- `args`: A comma-separated list of arguments to substitute into format.

## Return Value

Return Value A text provider object built from the specified arguments.

## Discussion

Discussion Use this method to create a text provider comprising text and the content of other objects, including other text providers.