Generic Structure

ListFormatStyle

A type used to format lists of items with a separator and conjunction appropriate for a given locale. 項目いくつかからなるリストそれらをある与えられたロケールに適した区切りと接続詞で書式設定するために使われるある型。

Declaration 宣言

struct ListFormatStyle<Style, Base> where Style : FormatStyle, Base : Sequence, Style.FormatInput == Base.Element, Style.FormatOutput == String

Overview 概要

A list format style creates human readable text from a Sequence of values. Customize the formatting behavior of the list using the width, listType, and locale properties. The system automatically caches unique configurations of ListFormatStyle to enhance performance. あるリスト書式設定スタイルは、人に読みやすいテキストを値いくつかからなるあるSequenceから作成します。リストの書式設定挙動をwidthlistType、そしてlocaleプロパティを使ってカスタマイズしてください。システムは、自動的にListFormatStyleの固有な構成設定それらをキャッシュすることで性能を高めます。

Use either formatted() or formatted(_:), both instance methods of Sequence, to create a string representation of the items. formatted()またはformatted(_:)のどちらか、両方ともSequenceのインスタンスメソッド、を使うことで項目それらからなるある文字列表現を作成してください。

The formatted() method applies the default list format style to a sequence of strings. For example: formatted()メソッドは、省略時のリスト書式設定スタイルを文字列いくつかからなるあるシーケンスに適用します。例えば:


["Kristin", "Paul", "Ana", "Bill"].formatted()
// Kristin, Paul, Ana, and Bill

You can customize a list’s type and width properties. あなたは、あるリストのもつtype and widthプロパティをカスタマイズできます。

  • The listType property specifies the semantics of the list. listTypeプロパティは、そのリストの意味論を指定します。

  • The width property determines the size of the returned string. widthプロパティは、返される文字列のサイズを決定します。

The formatted(_:) method to applies a custom list format style. You can use the static factory method list(type:width:) to create a custom list format style as a parameter to the method. formatted(_:)メソッドは、あるあつらえのリスト書式設定スタイルを適用します。あなたは、静的ファクトリメソッドlist(type:width:)を使って、あつらえのリスト書式設定スタイルをメソッドへのパラメータとして作成できます。

This example formats a sequence with a ListFormatStyle.ListType.and list type and ListFormatStyle.Width.short width: この例は、あるシーケンスをListFormatStyle.ListType.andリスト型とListFormatStyle.Width.short幅で書式設定します:


["Kristin", "Paul", "Ana", "Bill"].formatted(.list(type: .and, width: .short))
// Kristin, Paul, Ana, & Bill

You can provide a member format style to transform each list element to a string in applications where the elements aren’t already strings. For example, the following code sample uses an IntegerFormatStyle to convert a range of integer values into a list: あなたは、メンバー書式設定スタイルを提供することで、各リスト要素を文字列へとアプリケーションにおいて変形できます、そこで要素それらはまだ文字列ではありません。例えば、以下のコード例は、IntegerFormatStyleを使ってある範囲の整数値をリストへと変換します:


(5201719 ... 5201722).formatted(.list(memberStyle: IntegerFormatStyle(), type: .or, width: .standard))
// For locale: en_US: 5,201,719, 5,201,720, 5,201,721, or 5,201,722
// For locale: fr_CA: 5 201 719, 5 201 720, 5 201 721, ou 5 201 722

You can create and reuse a list format style instance to format similar sequences. For example: あなたは、あるリスト書式設定スタイルインスタンスを作成および再利用して、同様なシーケンスを書式設定できます。例えば:


let percentStyle = ListFormatStyle<FloatingPointFormatStyle.Percent, StrideThrough<Double>>(memberStyle: .percent)
stride(from: 7.5, through: 9.0, by: 0.5).formatted(percentStyle)
// 7.5%, 8%, 8.5%, and 9%
stride(from: 89.0, through: 95.0, by: 2.0).formatted(percentStyle)
// 89%, 91%, 93%, and 95%

Topics 話題

Creating a List Format Style リスト書式設定スタイルを作成する

Modifying a List Format Style リスト書式設定スタイルを修正する

Formatting a Sequence シーケンスを書式設定する

Encoding and Decoding エンコーディングとデコーディング

Working With Input and Output Types 入力および出力型を扱う

Hashing a List Format Style リスト書式設定スタイルをハッシュ化する

Comparing List Format Styles リスト書式設定スタイルを比較する

Relationships 関係

Conforms To 次に準拠

See Also 参照

Data Formatting in Swift Swiftでのデータ書式設定