---
title: "CFStringAppendFormatAndArguments(_:_:_:_:)"
framework: corefoundation
role: symbol
role_heading: Function
path: "corefoundation/cfstringappendformatandarguments(_:_:_:_:)"
---

# CFStringAppendFormatAndArguments(_:_:_:_:)

Appends a formatted string to the character contents of a CFMutableString object.

## Declaration

```swift
func CFStringAppendFormatAndArguments(_ theString: CFMutableString!, _ formatOptions: CFDictionary!, _ format: CFString!, _ arguments: CVaListPointer)
```

## Parameters

- `theString`: The string to which the formatted characters from format are appended. If this value is not a CFMutableString object, an assertion is raised.
- `formatOptions`: A dictionary containing formatting options for the string (such as the thousand-separator character, which is dependent on locale). Currently, these options are an unimplemented feature.
- `format`: A formatted string with printf-style specifiers.
- `arguments`: List of values to be inserted in format.

## Discussion

Discussion A formatted string is one with printf-style format specifiers embedded in the text such as %d (decimal), %f (double), and %@ (Core Foundation object). The subsequent arguments, in order, are substituted for the specifiers in the character data appended to theString. You can also reorder the arguments in the string by using modifiers of the form “n$” with the format specifiers (for example, %2$d). For more information on supported specifiers, see the relevant section in String Programming Guide for Core Foundation.

## See Also

### CFMutableString Miscellaneous Functions

- [CFStringAppend(_:_:)](corefoundation/cfstringappend(_:_:).md)
- [CFStringAppendCharacters(_:_:_:)](corefoundation/cfstringappendcharacters(_:_:_:).md)
- [CFStringAppendCString(_:_:_:)](corefoundation/cfstringappendcstring(_:_:_:).md)
- [CFStringAppendPascalString(_:_:_:)](corefoundation/cfstringappendpascalstring(_:_:_:).md)
- [CFStringCapitalize(_:_:)](corefoundation/cfstringcapitalize(_:_:).md)
- [CFStringCreateMutable(_:_:)](corefoundation/cfstringcreatemutable(_:_:).md)
- [CFStringCreateMutableCopy(_:_:_:)](corefoundation/cfstringcreatemutablecopy(_:_:_:).md)
- [CFStringCreateMutableWithExternalCharactersNoCopy(_:_:_:_:_:)](corefoundation/cfstringcreatemutablewithexternalcharactersnocopy(_:_:_:_:_:).md)
- [CFStringDelete(_:_:)](corefoundation/cfstringdelete(_:_:).md)
- [CFStringFindAndReplace(_:_:_:_:_:)](corefoundation/cfstringfindandreplace(_:_:_:_:_:).md)
- [CFStringFold(_:_:_:)](corefoundation/cfstringfold(_:_:_:).md)
- [CFStringInsert(_:_:_:)](corefoundation/cfstringinsert(_:_:_:).md)
- [CFStringLowercase(_:_:)](corefoundation/cfstringlowercase(_:_:).md)
- [CFStringNormalize(_:_:)](corefoundation/cfstringnormalize(_:_:).md)
- [CFStringPad(_:_:_:_:)](corefoundation/cfstringpad(_:_:_:_:).md)