struct
String.CharacterView
Inheritance |
CollectionType, Indexable, RangeReplaceableCollectionType, SequenceType
View Protocol Hierarchy →
|
---|---|
Associated Types |
Type alias inferred.
Type alias inferred.
Type alias inferred.
Type alias inferred. |
Nested Types | String.CharacterView.Index |
Import |
|
Initializers
Create an empty instance.
Declaration
init
()
Create an instance containing characters
.
Declaration
init
<
S
:
SequenceType
where
S
.
Generator
.
Element
==
Character
>
(
_
characters
:
S
)
Instance Variables
Returns the number of elements.
Complexity: O(1) if Index
conforms to RandomAccessIndexType
;
O(N) otherwise.
Declaration
var
count
:
String
.
CharacterView
.
Index
.
Distance
{
get
}
Declared In
RangeReplaceableCollectionType
, CollectionType
The "past the end" position.
endIndex
is not a valid argument to subscript
, and is always
reachable from startIndex
by zero or more applications of
successor()
.
Declaration
var
endIndex
:
String.CharacterView.Index
{
get
}
Returns the first element of self
, or nil
if self
is empty.
Complexity: O(1)
Declaration
var
first
:
Character
? {
get
}
Declared In
RangeReplaceableCollectionType
, CollectionType
Return the range of valid index values.
The result's endIndex
is the same as that of self
. Because
Range
is half-open, iterating the values of the result produces
all valid subscript arguments for self
, omitting its endIndex
.
Declaration
var
indices
:
Range
<
String.CharacterView.Index
>
{
get
}
Declared In
RangeReplaceableCollectionType
, CollectionType
Returns true
iff self
is empty.
Complexity: O(1)
Declaration
var
isEmpty
:
Bool
{
get
}
Declared In
RangeReplaceableCollectionType
, CollectionType
Declaration
var
last
:
Character
? {
get
}
Declared In
RangeReplaceableCollectionType
, CollectionType
A collection with contents identical to self
, but on which
normally-eager operations such as map
and filter
are
implemented lazily.
See Also: LazySequenceType
, LazyCollectionType
.
Declaration
var
lazy
:
LazyCollection
<
String.CharacterView
>
{
get
}
Declared In
RangeReplaceableCollectionType
, CollectionType
The position of the first Character
if self
is
non-empty; identical to endIndex
otherwise.
Declaration
var
startIndex
:
String.CharacterView.Index
{
get
}
6 inherited items hidden. (Show all)
Subscripts
Declaration
subscript
(
subRange
:
Range
<
String.CharacterView.Index
>
) -
>
String.CharacterView
{
get
}
Declaration
subscript
(
i
:
String.CharacterView.Index
) -
>
Character
{
get
}
Instance Methods
Append c
to self
.
Complexity: Amortized O(1).
Declaration
mutating
func
append
(
c
:
Character
)
Declared In
String.CharacterView
, RangeReplaceableCollectionType
Append the elements of newElements
to self
.
Declaration
mutating
func
appendContentsOf
<
S
:
SequenceType
where
S
.
Generator
.
Element
==
Character
>
(
newElements
:
S
)
Declared In
String.CharacterView
, RangeReplaceableCollectionType
Return true
iff an element in self
satisfies predicate
.
Declaration
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns a subsequence containing all but the first element.
Requires: n >= 0
Complexity: O(n
)
Declaration
func
dropFirst
() -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns a subsequence containing all but the first n
elements.
Requires: n >= 0
Complexity: O(n
)
Declaration
func
dropFirst
(
n
:
Int
) -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns a subsequence containing all but the last element.
Requires: self
is a finite sequence.
Requires: n >= 0
Complexity: O(self.count
)
Declaration
func
dropLast
() -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns a subsequence containing all but the last n
elements.
Requires: n >= 0
Complexity: O(self.count
)
Declaration
func
dropLast
(
n
:
Int
) -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return true
iff self
and other
contain the same elements in the
same order.
Declaration
func
elementsEqual
<
OtherSequence
:
SequenceType
where
OtherSequence
.
Generator
.
Element
==
Generator
.
Element
>
(
other
:
OtherSequence
) -
>
Bool
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return true iff self
and other
contain equivalent elements, using
isEquivalent
as the equivalence test.
Requires: isEquivalent
is an
equivalence relation.
Declaration
func
elementsEqual
<
OtherSequence
:
SequenceType
where
OtherSequence
.
Generator
.
Element
==
Generator
.
Element
>
(
other
:
OtherSequence
, @
noescape
isEquivalent
: (
Character
,
Character
)
throws
-
>
Bool
)
rethrows
-
>
Bool
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return a lazy SequenceType
containing pairs (n, x), where
ns are consecutive Int
s starting at zero, and xs are
the elements of base
:
for (n, c) in "Swift".characters.enumerate() {
(
"\(
n
): '\(
c
)'"
)
}
0
: '
S
'
1
: '
w
'
2
: '
i
'
3
: '
f
'
4
: '
t
'
Declaration
func
enumerate
() -
>
EnumerateSequence
<
String.CharacterView
>
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return an Array
containing the elements of self
,
in order, that satisfy the predicate includeElement
.
Declaration
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return an Array
containing the non-nil results of mapping
transform
over self
.
Complexity: O(M + N), where M is the length of self
and N is the length of the result.
Declaration
func
flatMap
<
T
>
(@
noescape
transform
: (
Character
)
throws
-
>
T
?)
rethrows
-
>
[
T
]
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return an Array
containing the concatenated results of mapping
transform
over self
.
s
.
flatMap
(
transform
)
is equivalent to
Array
(
s
.
map
(
transform
).
flatten
())
Complexity: O(M + N), where M is the length of self
and N is the length of the result.
Declaration
func
flatMap
<
S
:
SequenceType
>
(
transform
: (
Character
)
throws
-
>
S
)
rethrows
-
>
[
S
.
Generator
.
Element
]
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Call body
on each element in self
in the same order as a
for-in loop.
sequence
.
forEach
{
// body code
}
is similar to:
for
element
in
sequence
{
// body code
}
Note: You cannot use the break
or continue
statement to exit the
current call of the body
closure or skip subsequent calls.
Note: Using the return
statement in the body
closure will only
exit from the current call to body
, not any outer scope, and won't
skip subsequent calls.
Complexity: O(self.count
)
Declaration
func
forEach
(@
noescape
body
: (
Character
)
throws
-
>
())
rethrows
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Declaration
func
generate
() -
>
IndexingGenerator
<
String.CharacterView
>
Declared In
RangeReplaceableCollectionType
, CollectionType
Returns the first index where predicate
returns true
for the
corresponding value, or nil
if such value is not found.
Complexity: O(self.count
).
Declaration
func
indexOf
(@
noescape
predicate
: (
Character
)
throws
-
>
Bool
)
rethrows
-
>
String.CharacterView.Index
?
Declared In
RangeReplaceableCollectionType
, CollectionType
Insert newElement
at index i
.
Invalidates all indices with respect to self
.
Complexity: O(self.count
).
Declaration
mutating
func
insert
(
newElement
:
Character
,
atIndex
i
:
String.CharacterView.Index
)
Declared In
RangeReplaceableCollectionType
Insert newElements
at index i
.
Invalidates all indices with respect to self
.
Complexity: O(self.count + newElements.count
).
Declaration
mutating
func
insertContentsOf
<
C
:
CollectionType
where
C
.
Generator
.
Element
==
Generator
.
Element
>
(
newElements
:
C
,
at
i
:
String.CharacterView.Index
)
Declared In
RangeReplaceableCollectionType
Return true iff self
precedes other
in a lexicographical ("dictionary")
ordering, using "<" as the comparison between elements.
Note: This method implements the mathematical notion of lexicographical
ordering, which has no connection to Unicode. If you are sorting strings
to present to the end-user, you should use String
APIs that perform
localized comparison.
Declaration
func
lexicographicalCompare
<
OtherSequence
:
SequenceType
where
OtherSequence
.
Generator
.
Element
==
Generator
.
Element
>
(
other
:
OtherSequence
) -
>
Bool
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return true iff self
precedes other
in a lexicographical ("dictionary")
ordering, using isOrderedBefore
as the comparison between elements.
Note: This method implements the mathematical notion of lexicographical
ordering, which has no connection to Unicode. If you are sorting strings
to present to the end-user, you should use String
APIs that perform
localized comparison.
Requires: isOrderedBefore
is a
strict weak ordering
over the elements of self
and other
.
Declaration
func
lexicographicalCompare
<
OtherSequence
:
SequenceType
where
OtherSequence
.
Generator
.
Element
==
Generator
.
Element
>
(
other
:
OtherSequence
, @
noescape
isOrderedBefore
: (
Character
,
Character
)
throws
-
>
Bool
)
rethrows
-
>
Bool
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return an Array
containing the results of mapping transform
over self
.
Complexity: O(N).
Declaration
func
map
<
T
>
(@
noescape
transform
: (
Character
)
throws
-
>
T
)
rethrows
-
>
[
T
]
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns the maximum element in self
or nil
if the sequence is empty.
Complexity: O(elements.count
).
Declaration
func
maxElement
() -
>
Character
?
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns the maximum element in self
or nil
if the sequence is empty.
Complexity: O(elements.count
).
Requires: isOrderedBefore
is a
strict weak ordering.
over self
.
Declaration
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns the minimum element in self
or nil
if the sequence is empty.
Complexity: O(elements.count
).
Declaration
func
minElement
() -
>
Character
?
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns the minimum element in self
or nil
if the sequence is empty.
Complexity: O(elements.count
).
Requires: isOrderedBefore
is a
strict weak ordering.
over self
.
Declaration
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
If !self.isEmpty
, remove the first element and return it, otherwise
return nil
.
Complexity: O(self.count
)
Declaration
mutating
func
popFirst
() -
>
Character
?
Declared In
RangeReplaceableCollectionType
, CollectionType
If !self.isEmpty
, remove the last element and return it, otherwise
return nil
.
Complexity: O(self.count
)
Declaration
mutating
func
popLast
() -
>
Character
?
Declared In
RangeReplaceableCollectionType
, CollectionType
Returns a subsequence, up to maxLength
in length, containing the
initial elements.
If maxLength
exceeds self.count
, the result contains all
the elements of self
.
Requires: maxLength >= 0
Complexity: O(maxLength
)
Declaration
func
prefix
(
maxLength
:
Int
) -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns prefixUpTo(position.successor())
Complexity: O(1)
Declaration
func
prefixThrough
(
position
:
String.CharacterView.Index
) -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
Returns self[startIndex..<end]
Complexity: O(1)
Declaration
func
prefixUpTo
(
end
:
String.CharacterView.Index
) -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
Return the result of repeatedly calling combine
with an
accumulated value initialized to initial
and each element of
self
, in turn, i.e. return
combine(combine(...combine(combine(initial, self[0]),
self[1]),...self[count-2]), self[count-1])
.
Declaration
func
reduce
<
T
>
(
initial
:
T
, @
noescape
combine
: (
T
,
Character
)
throws
-
>
T
)
rethrows
-
>
T
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Remove all elements.
Invalidates all indices with respect to self
.
keepCapacity
: If true
, is a non-binding request to
avoid releasing storage, which can be a useful optimization
when self
is going to be grown again.
Complexity: O(self.count
).
Declaration
mutating
func
removeAll
(
keepCapacity
keepCapacity
:
Bool
=
default
)
Declared In
RangeReplaceableCollectionType
Remove the element at index i
.
Invalidates all indices with respect to self
.
Complexity: O(self.count
).
Declaration
mutating
func
removeAtIndex
(
index
:
String.CharacterView.Index
) -
>
Character
Declared In
RangeReplaceableCollectionType
Remove the element at startIndex
and return it.
Complexity: O(self.count
)
Requires: !self.isEmpty
.
Declaration
mutating
func
removeFirst
() -
>
Character
Declared In
RangeReplaceableCollectionType
, CollectionType
Remove the first n
elements.
Complexity: O(self.count
)
Requires: self.count >= n
.
Declaration
mutating
func
removeFirst
(
n
:
Int
)
Declared In
RangeReplaceableCollectionType
Remove an element from the end.
Complexity: O(1)
Requires: !self.isEmpty
Declaration
mutating
func
removeLast
() -
>
Character
Declared In
RangeReplaceableCollectionType
Remove the indicated subRange
of elements.
Invalidates all indices with respect to self
.
Complexity: O(self.count
).
Declaration
mutating
func
removeRange
(
subRange
:
Range
<
String.CharacterView.Index
>
)
Declared In
RangeReplaceableCollectionType
Replace the given subRange
of elements with newElements
.
Invalidates all indices with respect to self
.
Complexity: O(subRange.count
) if subRange.endIndex
== self.endIndex
and newElements.isEmpty
, O(N) otherwise.
Declaration
mutating
func
replaceRange
<
C
:
CollectionType
where
C
.
Generator
.
Element
==
Character
>
(
subRange
:
Range
<
String.CharacterView.Index
>
,
with
newElements
:
C
)
Reserve enough space to store n
ASCII characters.
Complexity: O(n
).
Declaration
mutating
func
reserveCapacity
(
n
:
Int
)
Declared In
String.CharacterView
, RangeReplaceableCollectionType
Return an Array
containing the elements of self
in reverse
order.
Complexity: O(N), where N is the length of self
.
Declaration
func
reverse
() -
>
[
Character
]
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return an Array
containing the sorted elements of source
.
The sorting algorithm is not stable (can change the relative order of elements that compare equal).
Requires: The less-than operator (func <
) defined in
the Comparable
conformance is a
strict weak ordering
over the elements in self
.
Declaration
func
sort
() -
>
[
Character
]
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return an Array
containing the sorted elements of source
according to isOrderedBefore
.
The sorting algorithm is not stable (can change the relative order of
elements for which isOrderedBefore
does not establish an order).
Requires: isOrderedBefore
is a
strict weak ordering
over the elements in self
.
Declaration
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns the maximal SubSequence
s of self
, in order, that
don't contain elements satisfying the predicate isSeparator
.
maxSplit
: The maximum number of SubSequence
s to
return, minus 1.
If maxSplit + 1
SubSequence
s are returned, the last one is
a suffix of self
containing the remaining elements.
The default value is Int.max
.
allowEmptySubsequences
: If true
, an empty SubSequence
is produced in the result for each pair of consecutive elements
satisfying isSeparator
.
The default value is false
.
Requires: maxSplit >= 0
Declaration
func
split
(
maxSplit
:
Int
=
default
,
allowEmptySlices
:
Bool
=
default
, @
noescape
isSeparator
: (
Character
)
throws
-
>
Bool
)
rethrows
-
>
[
String.CharacterView
]
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns the maximal SubSequence
s of self
, in order, around a
separator
element.
maxSplit
: The maximum number of SubSequence
s to
return, minus 1.
If maxSplit + 1
SubSequence
s are returned, the last one is
a suffix of self
containing the remaining elements.
The default value is Int.max
.
allowEmptySubsequences
: If true
, an empty SubSequence
is produced in the result for each pair of consecutive elements
satisfying isSeparator
.
The default value is false
.
Requires: maxSplit >= 0
Declaration
func
split
(
separator
:
Character
,
maxSplit
:
Int
=
default
,
allowEmptySlices
:
Bool
=
default
) -
>
[
String.CharacterView
]
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return true iff the the initial elements of self
are equal to prefix
.
Return true if other
is empty.
Declaration
func
startsWith
<
OtherSequence
:
SequenceType
where
OtherSequence
.
Generator
.
Element
==
Generator
.
Element
>
(
other
:
OtherSequence
) -
>
Bool
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Return true iff self
begins with elements equivalent to those of
other
, using isEquivalent
as the equivalence test. Return true if
other
is empty.
Requires: isEquivalent
is an
equivalence relation.
Declaration
func
startsWith
<
OtherSequence
:
SequenceType
where
OtherSequence
.
Generator
.
Element
==
Generator
.
Element
>
(
other
:
OtherSequence
, @
noescape
isEquivalent
: (
Character
,
Character
)
throws
-
>
Bool
)
rethrows
-
>
Bool
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns a slice, up to maxLength
in length, containing the
final elements of s
.
If maxLength
exceeds s.count
, the result contains all
the elements of s
.
Requires: maxLength >= 0
Complexity: O(self.count
)
Declaration
func
suffix
(
maxLength
:
Int
) -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
Returns self[start..<endIndex]
Complexity: O(1)
Declaration
func
suffixFrom
(
start
:
String.CharacterView.Index
) -
>
String.CharacterView
Declared In
RangeReplaceableCollectionType
, CollectionType
Returns a value less than or equal to the number of elements in
self
, nondestructively.
Complexity: O(N).
Declaration
func
underestimateCount
() -
>
Int
Declared In
RangeReplaceableCollectionType
, CollectionType
, SequenceType
45 inherited items hidden. (Show all)
A
String
's collection ofCharacter
s (extended grapheme clusters) elements.