Instance Method インスタンスメソッド

getObjectValue:forString:range:error:

Returns by reference a cell-content object after creating it from a range of characters in a given string. あるセル内容オブジェクトを、それをある与えられた文字列の中のある範囲の文字から作成した後に、参照によって返します。

Declaration 宣言 

- (BOOL)getObjectValue:(out id  _Nullable *)obj 
             forString:(NSString *)string 
                 range:(inout NSRange *)rangep 
                 error:(out NSError * _Nullable *)error;

Parameters パラメータ

anObject

On return, contains an instance of NSDecimalNumber or NSNumber based on the current value of the generatesDecimalNumbers property. Returns nil by reference if conversion failed. 戻りでは、NSDecimalNumberまたはNSNumberのインスタンスを、generatesDecimalNumbersプロパティの現在の値に基づき含みます。もし変換が失敗したならば参照によってnilを返します。

aString

A string object with the range of characters specified in rangep that is used to create anObject. rangepにおいて指定される文字の範囲での文字列オブジェクト、それはanObjectを作成するのに使われます。

rangep

A range of characters in aString. On return, contains the actual range of characters used to create the object. aStringの中の文字それらの範囲。戻りでは、オブジェクトを作成するのに使われた文字の実際の範囲。

error

If an error occurs, upon return contains an NSError object in the NSCocoaErrorDomain with code NSFormattingError that explains why the conversion failed. If you pass in nil for error you are indicating that you are not interested in error information. エラーが発生するならば、戻りではコードNSFormattingErrorをもつNSCocoaErrorDomainの中のあるNSErrorオブジェクトを含みます、それはなぜ変換が失敗したかを説明します。あなたがnilをerrorに渡すならば、あなたがエラー情報を重要に思っていないことをあなたは指し示しています。

Return Value 戻り値

YES if the conversion from string to cell-content object was successful, otherwise NO. YES、もし文字列からセル内容オブジェクトへの変換が成功したならば、そうでなければNO。

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. 文字列におけるあらゆる先行または後続の空白分離子文字は無視されます。例えば、文字列 “ 5”、“5 ”、そして “5” は全て数5を生成します。

If there is an error, this method calls control:didFailToFormatString:errorDescription: on the delegate. エラーがあるならば、このメソッドはcontrol:didFailToFormatString:errorDescription:を委任先で呼び出します。

See Also 参照

Converting Between Numbers and Strings 数値と文字列の間で変換する

- numberFromString:
Returns an NSNumber object created by parsing a given string. 与えられた文字列を構文解析することによって作成されるNSNumberオブジェクトを返します。
- stringFromNumber:
Returns a string containing the formatted value of the provided number object. 提供された数値オブジェクトの書式設定された値を含んでいる文字列を返します。
+ localizedStringFromNumber:numberStyle:
Returns a localized number string with the specified style. 指定された形式でローカライズされた数値文字列を返します。