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

prefix(_:)

Returns a subsequence, up to the specified maximum length, containing the initial elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの冒頭の要素を含めて返します。

Declaration 宣言 

func prefix(_ maxLength: Int) -> Substring

Parameters パラメータ

maxLength

The maximum number of elements to return. maxLength must be greater than or equal to zero. 返される要素の最大限の数。maxLengthは、ゼロより大きいか等しくなければなりません。

Return Value 戻り値

A subsequence starting at the beginning of this collection with at most maxLength elements. このコレクションの先端で始まる多くともmaxLength要素の下位シーケンス。

Discussion 解説

If the maximum length exceeds the number of elements in the collection, the result contains all the elements in the collection. 最大長がコレクションの要素の数を越えるならば、結果はコレクションの要素すべてを含みます。 


let numbers = [1, 2, 3, 4, 5]
print(numbers.prefix(2))
// Prints "[1, 2]"
print(numbers.prefix(10))
// Prints "[1, 2, 3, 4, 5]"

Complexity: O(1) if the collection conforms to RandomAccessCollection; otherwise, O(k), where k is the number of elements to select from the beginning of the collection. 計算量：コレクションがRandomAccessCollectionに準拠するならば、O(1)；そうでなければ、O(k)、そこでkはコレクションの冒頭から選択する要素の数です。

See Also 参照

Getting Substrings 下位文字列を取得する

subscript(Range<String.Index>) -> Substring
Accesses a contiguous subrange of the collection’s elements. コレクションのもついくらかの要素からなるある連続した下位範囲にアクセスします。
subscript<R>(R) -> Substring
Accesses the contiguous subrange of the collection’s elements specified by a range expression. 範囲式によって指定される、コレクションの要素からなる連続した下位範囲にアクセスします。
subscript((UnboundedRange_) -> ()) -> Substring
func prefix(through: Index) -> Substring
Returns a subsequence from the start of the collection through the specified position. コレクションの始まりから指定された位置までも含む下位シーケンスを返します。
func prefix(upTo: Index) -> Substring
Returns a subsequence from the start of the collection up to, but not including, the specified position. コレクションの始まりから指定された位置まで、しかしそれは含めない下位シーケンスを返します。
func prefix(while: (Character) -> Bool) -> Substring
Returns a subsequence containing the initial elements until predicate returns false and skipping the remaining elements. predicateがfalseを返すまで冒頭の要素を含んでいて残りの要素を飛ばしている、ある下位シーケンスを返します。
func suffix(Int) -> Substring
Returns a subsequence, up to the given maximum length, containing the final elements of the collection. 下位シーケンスを、指定された最大長まで、コレクションの末尾の要素を含めて返します。
func suffix(from: Index) -> Substring
Returns a subsequence from the specified position to the end of the collection. 指定された位置からコレクションの終わりまでの下位シーケンスを返します。