String.UTF8View.Index

struct String.UTF8View.Index

A position in a String.UTF8View.

Inheritance Equatable, ForwardIndexType, _Incrementable View Protocol Hierarchy →
Import import Swift

Initializers

init(_: Index, within: String.UTF8View)

Construct the position in utf8 that corresponds exactly to characterIndex.

Requires: characterIndex is an element of String(utf8)!.indices.

Declaration

init(_ characterIndex: Index, within utf8: String.UTF8View)
init(_: UnicodeScalarIndex, within: String.UTF8View)

Construct the position in utf8 that corresponds exactly to unicodeScalarIndex.

Requires: unicodeScalarIndex is an element of String(utf8)!.unicodeScalars.indices.

Declaration

init(_ unicodeScalarIndex: UnicodeScalarIndex, within utf8: String.UTF8View)
init?(_:within:)

Construct the position in utf8 that corresponds exactly to utf16Index. If no such position exists, the result is nil.

Requires: utf8Index is an element of String(utf16)!.utf8.indices.

Declaration

init?(_ utf16Index: UTF16Index, within utf8: String.UTF8View)

Instance Methods

func advancedBy(_:)

Returns the result of advancing self by n positions.

Returns: - If n > 0, the result of applying successor to self n times. - If n < 0, the result of applying predecessor to self -n times. - Otherwise, self.

Requires: n >= 0 if only conforming to ForwardIndexType Complexity: - O(1) if conforming to RandomAccessIndexType - O(abs(n)) otherwise

Declaration

func advancedBy(n: String.UTF8View.Index.Distance) -> String.UTF8View.Index

Declared In

ForwardIndexType
func advancedBy(_:limit:)

Returns the result of advancing self by n positions, or until it equals limit.

Returns: - If n > 0, the result of applying successor to self n times but not past limit. - If n < 0, the result of applying predecessor to self -n times but not past limit. - Otherwise, self.

Requires: n >= 0 if only conforming to ForwardIndexType.

Complexity: - O(1) if conforming to RandomAccessIndexType - O(abs(n)) otherwise

Declaration

func advancedBy(n: String.UTF8View.Index.Distance, limit: String.UTF8View.Index) -> String.UTF8View.Index

Declared In

ForwardIndexType
func distanceTo(_:)

Measure the distance between self and end.

Requires: - start and end are part of the same sequence when conforming to RandomAccessSequenceType. - end is reachable from self by incrementation otherwise.

Complexity: - O(1) if conforming to RandomAccessIndexType - O(n) otherwise, where n is the function's result.

Declaration

func distanceTo(end: String.UTF8View.Index) -> String.UTF8View.Index.Distance

Declared In

ForwardIndexType
func samePositionIn(_: String)

Returns the position in characters that corresponds exactly to self, or if no such position exists, nil.

Requires: self is an element of characters.utf8.indices.

Declaration

func samePositionIn(characters: String) -> Index?
func samePositionIn(_: String.UTF16View)

Returns the position in utf16 that corresponds exactly to self, or if no such position exists, nil.

Requires: self is an element of String(utf16)!.utf8.indices.

Declaration

func samePositionIn(utf16: String.UTF16View) -> String.UTF16View.Index?
func samePositionIn(_: String.UnicodeScalarView)

Returns the position in unicodeScalars that corresponds exactly to self, or if no such position exists, nil.

Requires: self is an element of String(unicodeScalars).utf8.indices.

Declaration

func samePositionIn(unicodeScalars: String.UnicodeScalarView) -> UnicodeScalarIndex?
func successor()

Returns the next consecutive value after self.

Requires: The next value is representable.

Declaration

func successor() -> String.UTF8View.Index