Protocol

StringProtocol

A type that can represent a string as a collection of characters. 文字列を文字のコレクションとして表すことができる型。

Declaration 宣言 

protocol StringProtocol where Self.Element == Character, Self.Index == String.Index, Self.StringInterpolation == DefaultStringInterpolation, Self.SubSequence : StringProtocol

Overview 概要

Do not declare new conformances to StringProtocol. Only the String and Substring types in the standard library are valid conforming types. 新しい準拠事項をStringProtocolに宣言しないでください。StringとSubstring型だけが標準ライブラリにおいて有効な準拠する型です。

Topics 話題

Associated Types さまざまな関連型

associatedtype SubSequence

Required. 必須。

associatedtype UTF16View

Required. 必須。

associatedtype UTF8View

Required. 必須。

associatedtype UnicodeScalarView

Required. 必須。

Initializers イニシャライザ

init(cString: UnsafePointer<CChar>)
Creates a string from the null-terminated, UTF-8 encoded sequence of bytes at the given pointer. 与えられたポインタでの、null終端の、UTF-8エンコードされたバイトシーケンスから文字列を作成します。

Required. 必須。

init<C, Encoding>(decoding: C, as: Encoding.Type)
Creates a string from the given Unicode code units in the specified encoding. 与えられたユニコード単位から指定されたエンコーディングで文字列を作成する。

Required. 必須。

init<Encoding>(decodingCString: UnsafePointer<Encoding.CodeUnit>, as: Encoding.Type)
Creates a string from the null-terminated sequence of bytes at the given pointer. 与えられたポインタでのnull終端のバイトシーケンスから文字列を作成します。

Required. 必須。

Instance Properties 様々なインスタンスプロパティ

var capitalized: String
var decomposedStringWithCanonicalMapping: String
var decomposedStringWithCompatibilityMapping: String
var fastestEncoding: String.Encoding
var hash: Int
var localizedCapitalized: String
var localizedLowercase: String
var localizedUppercase: String
var precomposedStringWithCanonicalMapping: String
var precomposedStringWithCompatibilityMapping: String
var removingPercentEncoding: String?
var smallestEncoding: String.Encoding
var unicodeScalars: Self.UnicodeScalarView

Required. 必須。

var utf16: Self.UTF16View

Required. 必須。

var utf8: Self.UTF8View

Required. 必須。

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

func addingPercentEncoding(withAllowedCharacters: CharacterSet) -> String?
func appending<T>(T) -> String
func appendingFormat<T>(T, CVarArg...) -> String
func applyingTransform(StringTransform, reverse: Bool) -> String?
func cString(using: String.Encoding) -> [CChar]?
func canBeConverted(to: String.Encoding) -> Bool
func capitalized(with: Locale?) -> String
func caseInsensitiveCompare<T>(T) -> ComparisonResult
func commonPrefix<T>(with: T, options: String.CompareOptions) -> String
func compare<T>(T, options: String.CompareOptions, range: Range<Self.Index>?, locale: Locale?) -> ComparisonResult
func completePath(into: UnsafeMutablePointer<String>?, caseSensitive: Bool, matchesInto: UnsafeMutablePointer<[String]>?, filterTypes: [String]?) -> Int
func components(separatedBy: CharacterSet) -> [String]
func components<T>(separatedBy: T) -> [String]
func contains<T>(T) -> Bool
func data(using: String.Encoding, allowLossyConversion: Bool) -> Data?
func enumerateLines(invoking: (String, inout Bool) -> Void)
func enumerateLinguisticTags<T, R>(in: R, scheme: T, options: NSLinguisticTagger.Options, orthography: NSOrthography?, invoking: (String, Range<Self.Index>, Range<Self.Index>, inout Bool) -> Void)
func enumerateSubstrings<R>(in: R, options: String.EnumerationOptions, (String?, Range<Self.Index>, Range<Self.Index>, inout Bool) -> Void)
func folding(options: String.CompareOptions, locale: Locale?) -> String
func getBytes<R>(inout [UInt8], maxLength: Int, usedLength: UnsafeMutablePointer<Int>, encoding: String.Encoding, options: String.EncodingConversionOptions, range: R, remaining: UnsafeMutablePointer<Range<Self.Index>>) -> Bool
func getCString(inout [CChar], maxLength: Int, encoding: String.Encoding) -> Bool
func getLineStart<R>(UnsafeMutablePointer<Self.Index>, end: UnsafeMutablePointer<Self.Index>, contentsEnd: UnsafeMutablePointer<Self.Index>, for: R)
func getParagraphStart<R>(UnsafeMutablePointer<Self.Index>, end: UnsafeMutablePointer<Self.Index>, contentsEnd: UnsafeMutablePointer<Self.Index>, for: R)
func hasPrefix(String) -> Bool

Required. Default implementation provided. 必須。 省略時の実装の提供。

func hasSuffix(String) -> Bool

Required. Default implementation provided. 必須。 省略時の実装の提供。

func lengthOfBytes(using: String.Encoding) -> Int
func lineRange<R>(for: R) -> Range<Self.Index>
func linguisticTags<T, R>(in: R, scheme: T, options: NSLinguisticTagger.Options, orthography: NSOrthography?, tokenRanges: UnsafeMutablePointer<[Range<Self.Index>]>?) -> [String]
func localizedCaseInsensitiveCompare<T>(T) -> ComparisonResult
func localizedCaseInsensitiveContains<T>(T) -> Bool
func localizedCompare<T>(T) -> ComparisonResult
func localizedStandardCompare<T>(T) -> ComparisonResult
func localizedStandardContains<T>(T) -> Bool
func localizedStandardRange<T>(of: T) -> Range<Self.Index>?
func lowercased() -> String

Required. 必須。

func lowercased(with: Locale?) -> String
func maximumLengthOfBytes(using: String.Encoding) -> Int
func padding<T>(toLength: Int, withPad: T, startingAt: Int) -> String
func paragraphRange<R>(for: R) -> Range<Self.Index>
func propertyList() -> Any
func propertyListFromStringsFileFormat() -> [String : String]
func range<T>(of: T, options: String.CompareOptions, range: Range<Self.Index>?, locale: Locale?) -> Range<Self.Index>?
func rangeOfCharacter(from: CharacterSet, options: String.CompareOptions, range: Range<Self.Index>?) -> Range<Self.Index>?
func rangeOfComposedCharacterSequence(at: Self.Index) -> Range<Self.Index>
func rangeOfComposedCharacterSequences<R>(for: R) -> Range<Self.Index>
func replacingCharacters<T, R>(in: R, with: T) -> String
func replacingOccurrences<Target, Replacement>(of: Target, with: Replacement, options: String.CompareOptions, range: Range<Self.Index>?) -> String
func substring(from: Self.Index) -> StringDeprecated 非推奨
func substring(to: Self.Index) -> StringDeprecated 非推奨
func substring(with: Range<Self.Index>) -> StringDeprecated 非推奨
func trimmingCharacters(in: CharacterSet) -> String
func uppercased() -> String

Required. 必須。

func uppercased(with: Locale?) -> String
func withCString<Result>((UnsafePointer<CChar>) -> Result) -> Result
Calls the given closure with a pointer to the contents of the string, represented as a null-terminated sequence of UTF-8 code units. null終端のUTF-8コード単位シーケンスとして表される、文字列の内容へのポインタとともに与えられたクロージャを呼び出します。

Required. 必須。

func withCString<Result, Encoding>(encodedAs: Encoding.Type, (UnsafePointer<Encoding.CodeUnit>) -> Result) -> Result
Calls the given closure with a pointer to the contents of the string, represented as a null-terminated sequence of code units. null終端のコード単位シーケンスとして表される、文字列の内容へのポインタとともに与えられたクロージャを呼び出します。

Required. 必須。

func write(to: URL, atomically: Bool, encoding: String.Encoding)
func write<T>(toFile: T, atomically: Bool, encoding: String.Encoding)

Operator Functions 演算子関数

static func != <RHS>(Self, RHS) -> Bool
static func == <RHS>(Self, RHS) -> Bool
Returns a Boolean value indicating whether two values are equal. ２つの値が等しいかどうかを指し示すブール値を返します。

Relationships 関係

Inherits From 継承元

Conforming Types これらの型が準拠

See Also 参照

Related String Types 関連した文字列型

struct Substring
A slice of a string. ある文字列のスライス。
struct String.Index
A position of a character or code unit in a string. 文字列の中のある文字またはコード単位の位置。
struct String.UnicodeScalarView
A view of a string’s contents as a collection of Unicode scalar values. ある文字列の内容のひとつの見方、いくらかのユニコードスカラー値のコレクションとして。
struct String.UTF16View
A view of a string’s contents as a collection of UTF-16 code units. ある文字列の内容のひとつの見方、いくらかのUTF-16コード単位のコレクションとして。
struct String.UTF8View
A view of a string’s contents as a collection of UTF-8 code units. ある文字列の内容のひとつの見方、いくらかのUTF-8コード単位のコレクションとして。
struct String.Iterator
A type that provides the collection’s iteration interface and encapsulates its iteration state. そのコレクションの持つ反復インターフェイスを提供してそれの反復状態をカプセル化するある型。
struct String.Encoding