Class

NSFormatter

An abstract class that declares an interface for objects that create, interpret, and validate the textual representation of values. 値のテキスト表現を作成、解釈、そして確認するオブジェクトへのインターフェイスを宣言する抽象クラス。

Declaration 宣言

@interface NSFormatter : NSObject

Overview 概要

The Foundation framework provides several concrete subclasses of NSFormatter, including NSByteCountFormatter, NSDateFormatter, NSDateComponentsFormatter, NSDateIntervalFormatter, NSMeasurementFormatter, NSNumberFormatter, and NSPersonNameComponentsFormatter. FoundationフレームワークはNSFormatterのいくつかの具象サブクラスを提供し、それは次を含みます、NSByteCountFormatter, NSDateFormatter, NSDateComponentsFormatter, NSDateIntervalFormatter, NSMeasurementFormatter, NSNumberFormatter, そしてNSPersonNameComponentsFormatter。

Subclassing Notes サブクラス作成の注意

NSFormatter is intended for subclassing. A custom formatter can restrict the input and enhance the display of data in novel ways. For example, you could have a custom formatter that ensures that serial numbers entered by a user conform to predefined formats. Before you decide to create a custom formatter, make sure that you cannot configure the public subclasses to satisfy your requirements. NSFormatterは、サブクラスを作ることを意図されます。あつらえのフォーマッタは、入力を制限して、データの表示を斬新な方法で向上します。例えば、あなたは、ユーザによって入力されるシリアルナンバーがあらかじめ定義された形式に従うことを確実にするあつらえのフォーマッタを持つことができます。あつらえのフォーマッタの作成をあなたが決定する前に、あなたがパブリックサブクラスを構成設定してあなたの要件を満たすことができないことに気をつけてください。

For instructions on how to create your own custom formatter, see Creating a Custom Formatter. あなた独自のあつらえのフォーマッタを作成する方法に関する説明書として、Creating a Custom Formatterを見てください。

Topics 話題

Getting Textual Representations of Object Values オブジェクト値のテキスト表現を得る

- stringForObjectValue:

The default implementation of this method raises an exception. このメソッドの省略時の実装は例外を引き起こします。

- attributedStringForObjectValue:withDefaultAttributes:

The default implementation returns nil to indicate that the formatter object does not provide an attributed string. 省略時の実装は、nilを返して、フォーマッタオブジェクトが属性付き文字列を提供しないことを指し示します。

- editingStringForObjectValue:

The default implementation of this method invokes stringForObjectValue:. このメソッドの省略時の実装は、stringForObjectValue:を発動します。

Getting Object Values for Textual Representations テキスト表現に対するオブジェクト値を得る

- getObjectValue:forString:errorDescription:

The default implementation of this method raises an exception. このメソッドの省略時の実装は例外を引き起こします。

Validating Partial Strings 部分的な文字列を検証する

- isPartialStringValid:newEditingString:errorDescription:

Returns a Boolean value that indicates whether a partial string is valid. 不完全な文字列が有効かどうかを指し示すブール値を返します。

- isPartialStringValid:proposedSelectedRange:originalString:originalSelectedRange:errorDescription:

This method should be implemented in subclasses that want to validate user changes to a string in a field, where the user changes are not necessarily at the end of the string, and preserve the selection (or set a different one, such as selecting the erroneous part of the string the user has typed). このメソッドは、欄内の文字列へのユーザの変更を検証したいサブクラスにおいて実装されるべきです、そこにおいてユーザのする変更は、必ずしも文字列の終わりにではありません、そして選択の維持（または異なるものを設定すること、例えばユーザがタイプした文字列の誤り部分の選択など）ではありません。

Constants 定数

NSFormattingContext

The formatting context for a formatter. あるフォーマッタのための書式設定文脈。

NSFormattingUnitStyle

Specifies the width of the unit, determining the textual representation. テキスト表現を判断して、単位の幅を指定します。

Relationships 関係

Inherits From 継承元

NSObject