Class

Formatter

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

Declaration 宣言 

class Formatter : NSObject

Overview 概要

The Foundation framework provides several concrete subclasses of Formatter, including ByteCountFormatter, DateFormatter, DateComponentsFormatter, DateIntervalFormatter, MeasurementFormatter, NumberFormatter, and PersonNameComponentsFormatter. FoundationフレームワークはFormatterのいくつかの具象サブクラスを提供し、それは次を含みます、ByteCountFormatter, DateFormatter, DateComponentsFormatter, DateIntervalFormatter, MeasurementFormatter, NumberFormatter, そしてPersonNameComponentsFormatter。

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

Formatter 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. Formatterは、サブクラスを作ることを意図されます。あつらえのフォーマッタは、入力を制限して、データの表示を斬新な方法で向上します。例えば、あなたは、ユーザによって入力されるシリアルナンバーがあらかじめ定義された形式に従うことを確実にするあつらえのフォーマッタを持つことができます。あつらえのフォーマッタの作成をあなたが決定する前に、あなたがパブリックサブクラスを構成設定してあなたの要件を満たすことができないことに気をつけてください。

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

Topics 話題

Creating Formatters フォーマッタを作成する

Displaying Human-Friendly Content 人にやさしい内容を表示する
Convert data into readable strings or Swift objects using formatters. テータを読出可能文字列またはSwiftオブジェクトへとフォーマッタを使って変換します。

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

func string(for: Any?) -> String?
The default implementation of this method raises an exception. このメソッドの省略時の実装は例外を引き起こします。
func attributedString(for: Any, withDefaultAttributes: [NSAttributedString.Key : Any]?) -> NSAttributedString?
The default implementation returns nil to indicate that the formatter object does not provide an attributed string. 省略時の実装は、nilを返して、フォーマッタオブジェクトが属性付き文字列を提供しないことを指し示します。
func editingString(for: Any) -> String?
The default implementation of this method invokes string(for:). このメソッドの省略時の実装は、string(for:)を発動します。

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

func getObjectValue(AutoreleasingUnsafeMutablePointer<AnyObject?>?, for: String, errorDescription: AutoreleasingUnsafeMutablePointer<NSString?>?) -> Bool
The default implementation of this method raises an exception. このメソッドの省略時の実装は例外を引き起こします。

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

func isPartialStringValid(String, newEditingString: AutoreleasingUnsafeMutablePointer<NSString?>?, errorDescription: AutoreleasingUnsafeMutablePointer<NSString?>?) -> Bool
Returns a Boolean value that indicates whether a partial string is valid. 不完全な文字列が有効かどうかを指し示すブール値を返します。
func isPartialStringValid(AutoreleasingUnsafeMutablePointer<NSString>, proposedSelectedRange: NSRangePointer?, originalString: String, originalSelectedRange: NSRange, errorDescription: AutoreleasingUnsafeMutablePointer<NSString?>?) -> Bool
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 定数

enum Formatter.Context
The formatting context for a formatter. あるフォーマッタのための書式設定文脈。
enum Formatter.UnitStyle
Specifies the width of the unit, determining the textual representation. テキスト表現を判断して、単位の幅を指定します。

Relationships 関係

Inherits From 継承元

Conforms To 次に準拠