# getObjectValue(_:for:range:) Returns by reference a cell-content object after creating it from a range of characters in a given string. ``` func getObjectValue(_ obj: AutoreleasingUnsafeMutablePointer?, for string: String, range rangep: UnsafeMutablePointer?) throws ``` ## Parameters `obj` On return, contains an instance of [`NSDecimalNumber`](/documentation/Foundation/NSDecimalNumber) or [`NSNumber`](/documentation/Foundation/NSNumber) based on the current value of the [`generatesDecimalNumbers`](/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 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. > Handling Errors in Swift: > 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](https://docs.swift.org/swift-book/LanguageGuide/ErrorHandling.html) in [The Swift Programming Language](https://docs.swift.org/swift-book/) and `About Imported Cocoa Error Parameters`. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)