---
title: "getObjectValue(_:for:range:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/numberformatter/getobjectvalue(_:for:range:)"
---

# getObjectValue(_:for:range:)

Returns by reference a cell-content object after creating it from a range of characters in a given string.

## Declaration

```swift
func getObjectValue(_ obj: AutoreleasingUnsafeMutablePointer<AnyObject?>?, for string: String, range rangep: UnsafeMutablePointer<NSRange>?) throws
```

## Parameters

- `obj`: On return, contains an instance of doc://com.apple.foundation/documentation/Foundation/NSDecimalNumber or doc://com.apple.foundation/documentation/Foundation/NSNumber based on the current value of the doc://com.apple.foundation/documentation/Foundation/NumberFormatter/generatesDecimalNumbers property. Returns nil by reference if conversion failed.
- `string`: A string object with the range of characters specified in rangep that is used to create anObject.
- `rangep`: A range of characters in aString. On return, contains the actual range of characters used to create the object.

## Discussion

Discussion If a string contains any characters other than numerical digits or locale-appropriate group or decimal separators, parsing will fail. Any leading or trailing space separator characters in a string are ignored. For example, the strings “ 5”, “5 “, and “5” all produce the number 5. If there is an error, this method calls control(_:didFailToFormatString:errorDescription:) on the delegate. note: In Swift, this method returns Void and is marked with the throws keyword to indicate that it throws an error in cases of failure. You call this method in a try expression and handle any errors in the catch clauses of a do statement, as described in Error Handling in The Swift Programming Language and About Imported Cocoa Error Parameters.

## See Also

### Converting Between Numbers and Strings

- [number(from:)](foundation/numberformatter/number(from:).md)
- [string(from:)](foundation/numberformatter/string(from:).md)
- [localizedString(from:number:)](foundation/numberformatter/localizedstring(from:number:).md)