Structure

AttributedSubstring

A portion of an attributed string. 属性付き文字列のある部分。

Declaration 宣言 

@dynamicMemberLookup struct AttributedSubstring

Overview 概要

AttributedSubstring provides no-copy access to the contents of the string within the relevant range. The distinction between an AttributedString and an AttributedSubstring lets you distinguish between whether you’re in possession of an entire string or just a slice of it. AttributedSubstringは、非コピーアクセスを、関連範囲内の文字列の内容に提供します。AttributedStringとAttributedSubstringの違いは、あなたにあなたが全文字列の所有をしているかまたは単にそれのスライス（一断片）かを区別させます。

Because AttributedSubstring and AttributedString both conform to AttributedStringProtocol, working with ranges of AttributedString is natural. Modifying attributes by range works the same as it does on the base string. AttributedSubstringとAttributedStringの両方ともAttributedStringProtocolに準拠することから、AttributedStringの範囲を扱うことは自然なことです。属性を範囲によって修正することは、それが基底文字列上で行うことと同じ働きをします。

If you use an AttributedSubstring to mutate its base AttributedString, you must perform your mutation inline, as the following example shows: あなたがAttributedSubstringを使ってそれの基底AttributedStringを変化させるならば、あなたはあなたの変化をインラインに実行しなければなりません、以下の例が示すように： 


// Correct:
attrStr[range].link = url


// Incorrect (copies the referenced range of the base
// AttributedString and mutates that):
var substr = attrStr[range]
substr.link = url

Topics 話題

Creating Attributed Substrings 属性付き下位文字列を作成する

init()
Creates an empty attributed substring. 空の属性付き下位文字列を作成します。

Applying and Modifying Attributes 属性の適用と修正

func setAttributes(AttributeContainer)
Sets the attributed substring’s attributes to those in a specified attribute container. 属性付き下位文字列のもつ属性をある指定された属性コンテナの中のそれらに設定します。
func settingAttributes(AttributeContainer) -> AttributedString
Returns an attributed string by setting the attributed string’s attributes to those in a specified attribute container. 属性付き文字列をその属性付き文字列のもつ属性それらをある指定された属性コンテナの中のそれらへと設定することによって返します。
func mergeAttributes(AttributeContainer, mergePolicy: AttributedString.AttributeMergePolicy)
Merges the attributed string’s attributes with those in a specified attribute container.
func mergingAttributes(AttributeContainer, mergePolicy: AttributedString.AttributeMergePolicy) -> AttributedString
Returns an attributed string by merging the attributed string’s attributes with those in a specified attribute container.
enum AttributedString.AttributeMergePolicy
An enumeration of behaviors to apply when merging attributes.
func replaceAttributes(AttributeContainer, with: AttributeContainer)
Replaces the attributed substring’s attributes with those in a specified attribute container. 属性付き下位文字列のもつ属性をある指定された属性コンテナの中のそれらと置き換えます。
func replacingAttributes(AttributeContainer, with: AttributeContainer) -> AttributedString
Returns an attributed string by replacing occurrences of attributes in one attribute container with those in another attribute container.

Searching for a Substring 下位文字列を検索する

func range<T>(of: T, options: String.CompareOptions, locale: Locale?) -> Range<AttributedString.Index>?
Returns the range of a substring in the attributed substring, if it exists. 属性付き下位文字列の中のある下位文字列の範囲を返します、もしそれが存在するならば。

Accessing a Range ある範囲にアクセスする

subscript<R>(R) -> AttributedSubstring
Returns a substring of the attributed substring that a range indicates. 属性付き下位文字列のある下位文字列を返します、それはある範囲が指し示すものです。

Accessing Indices インデックスにアクセスする

Accessing Indicies Within an Attributed Substring

Accessing Views into the Attributed Substring 属性付き下位文字列へのビューそれらにアクセスする

var characters: AttributedString.CharacterView
The characters of the attributed string, as a view into the underlying string. 属性付き文字列の文字それら、基礎をなす文字列へのあるビューとして。
struct AttributedString.CharacterView
A view into the underlying storage of the attributed string, as Unicode characters. 属性付き文字列の基礎をなすストレージへのあるビュー、Unicode文字それらとして。
var unicodeScalars: AttributedString.UnicodeScalarView
The Unicode scalars of the attributed string, as a view into the underlying string. 属性付き文字列のUnicodeスカラーそれら、基礎をなす文字列へのあるビューとして。
struct AttributedString.UnicodeScalarView
A view into the underlying storage of the attributed string, as Unicode scalars. 属性付き文字列の基礎をなすストレージへのあるビュー、Unicodeスカラーそれらとして。
var runs: AttributedString.Runs
The attributed runs of the attributed string, as a view into the underlying string. 属性付き文字列の属性付きrunそれら、基礎をなす文字列へのあるビューとして。
struct AttributedString.Runs
An iterable view into segments of the attributed string, each of which indicates where a run of identical attributes begins or ends. 属性付き文字列の分節それらへのある反復可能ビュー、そのそれぞれは一致している属性それらからなるあるrunが始まるまたは終わるところを指し示します。

Accessing the Underlying Attributed String 基礎をなす属性付き文字列にアクセスする

var base: AttributedString
Returns the underlying attributed string that the attributed substring derives from. 属性付き下位文字列がそれから派生する基礎をなす属性付き文字列を返します。

Accessing Whole-Substring Attributes 下位文字列属性全体にアクセスする

subscript<K>(K.Type) -> K.Value?
Returns an attribute value that corresponds to an attributed string key. ある属性値を返します、それはある属性付き文字列キーに対応するものです。
subscript<K>(dynamicMember: KeyPath<AttributeDynamicLookup, K>) -> K.Value?
Returns an attribute value that a key path indicates. ある属性値を返します、それはあるキーパスが指し示すものです。
enum AttributeDynamicLookup
A type to support dynamic member lookup of attributes and containers. 属性とコンテナの動的メンバ検索をサポートするための型。
subscript<S>(dynamicMember: KeyPath<AttributeScopes, S.Type>) -> ScopedAttributeContainer<S>
Returns a scoped attribute container that a key path indicates. あるスコープ付き属性コンテナを返します、それはあるキーパスが指し示すものです。
struct ScopedAttributeContainer
An attribute container that allows dynamic member lookup of its contents within the specified attribute scope. ある属性コンテナを返します、それはそれの内容の動的メンバ検索をこの指定された属性スコープ内で可能にするものです。

Comparing Attributed Substrings 属性付き下位文字列を比較する

static func == (AttributedSubstring, AttributedSubstring) -> Bool
Returns a Boolean value that indicates whether two attributed substrings are equal. あるブール値を返します、それは２つの属性付き下位文字列が等しいかどうかを指し示します。
static func == <RHS>(AttributedSubstring, RHS) -> Bool
Returns a Boolean value that indicates whether an attributed substring and another attributed string or substring are equal. あるブール値を返します、それはある属性付下位文字列と別の属性付文字列または下位文字列が等しいかどうかを指し示します。
static func != (AttributedSubstring, AttributedSubstring) -> Bool
Returns a Boolean value that indicates whether two attributed substrings are not equal. あるブール値を返します、それは２つの属性付き下位文字列が等しくないかどうかを指し示します。

Hashing ハッシュ化

var hashValue: Int
The hash value. ハッシュ値。
func hash(into: inout Hasher)
Hashes the essential components of this value by feeding them into the given hasher. この値の本質的な構成要素それらを、それらをこの与えられたハーシャーに供給する事によってハッシュ化します。

Describing the Attributed Substring 属性付き下位文字列を記述する

var description: String
A textual representation of the instance. インスタンスのテキスト表現。

Relationships 関係

Conforms To 次に準拠

See Also 参照

Strings with Metadata メタデータを持つ文字列

struct AttributedString
A value type for a string with associated attributes for portions of its text. それのテキストのいくつかの部分に関連属性をもつ文字列のための値型。
Attributed String Supporting Types 属性付き文字列のサポートする型
Types that the attributed string, attributed substring, and helper types extend or conform to, for sharing common functionality. 属性付き文字列、属性付き下位文字列、そしてヘルパー型がそれに及ぶまたは準拠する型、一般的機能性を共有するために。
class NSAttributedString
A string with associated attributes (such as visual style, hyperlinks, or accessibility data) for portions of its text. それのテキストの一部に対する結び付けられた属性（たとえば視覚形式、ハイパーリンク、またはアクセシビリティ・データなど）をもつ文字列。
class NSMutableAttributedString
A mutable string with associated attributes (such as visual style, hyperlinks, or accessibility data) for portions of its text. それのテキストの部分それらに関連付けられた属性（たとえば視覚的スタイル、ハイパーリンク、またはアクセシビリティデータ）をもつ可変文字列。