---
title: "CFNumberFormatterCreateStringWithValue(_:_:_:_:)"
framework: Core Foundation
role: symbol
role_heading: Function
path: "corefoundation/cfnumberformattercreatestringwithvalue(_:_:_:_:)"
---

# CFNumberFormatterCreateStringWithValue(_:_:_:_:)

Returns a string representation of the given number or value using the specified number formatter.

## Declaration

```swift
func CFNumberFormatterCreateStringWithValue(_ allocator: CFAllocator!, _ formatter: CFNumberFormatter!, _ numberType: CFNumberType, _ valuePtr: UnsafeRawPointer!) -> CFString!
```

## Parameters

- `allocator`: The allocator to use to allocate memory for the new object. Pass NULL or doc://com.apple.corefoundation/documentation/CoreFoundation/kCFAllocatorDefault to use the current default allocator.
- `formatter`: The number formatter to use.
- `numberType`: The type of value that valuePtr references. Valid values are listed in doc://com.apple.corefoundation/documentation/CoreFoundation/CFNumberType.
- `valuePtr`: A pointer to the value to be converted.

## Return Value

Return Value A new string that represents the given number or value formatted by formatter. Returns NULL if there was a problem creating the object. Ownership follows the The Create Rule.

## See Also

### Formatting Values

- [CFNumberFormatterCreateNumberFromString(_:_:_:_:_:)](corefoundation/cfnumberformattercreatenumberfromstring(_:_:_:_:_:).md)
- [CFNumberFormatterCreateStringWithNumber(_:_:_:)](corefoundation/cfnumberformattercreatestringwithnumber(_:_:_:).md)
- [CFNumberFormatterGetDecimalInfoForCurrencyCode(_:_:_:)](corefoundation/cfnumberformattergetdecimalinfoforcurrencycode(_:_:_:).md)
- [CFNumberFormatterGetValueFromString(_:_:_:_:_:)](corefoundation/cfnumberformattergetvaluefromstring(_:_:_:_:_:).md)