文書 > Swift > Swift 標準ライブラリ > Collections > Range > firstIndex(where:)
インスタンスメソッド
firstIndex(where:)
コレクションの要素が与えられた predicate (述語) を満たす最初のインデックスを返します。
宣言
func firstIndex(where predicate: (Bound) throws -> Bool) rethrows -> Bound?
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
パラメータ
| predicate | 要素をその引数として取り、渡された要素が一致するかどうかを示すブール値を返すクロージャ。 |
戻り値
predicate (述語) が true を返す最初の要素のインデックス。コレクション内の要素が与えられた predicate (述語) を満たさない場合は、nil を返します。
議論
predicate (述語) を使用して、Equatable プロトコルに準拠しない型の要素を検索したり、特定の条件に一致する要素を検索したりすることができます。次に、文字 "A" で始まる学生の名前を見つける例を示します。
let students = ["Kofi", "Abena", "Peter", "Kweku", "Akosua"]
if let i = students.firstIndex(where: { $0.hasPrefix("A") }) {
print("\(students[i]) starts with 'A'!")
}
// Prints "Abena starts with 'A'!"
複雑さ：O(n)、ここで n はコレクションの長さです。
以下も見よ
要素の検索
func first(where: (Bound) -> Bool) -> Bound?
与えられた predicate (述語) を満たすシーケンスの最初の要素を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
func firstIndex(of: Bound) -> Bound?
指定された値がコレクションに現れる最初のインデックスを返します。
Element が Equatable に準拠している場合に使用可能です。
func last(where: (Bound) -> Bool) -> Bound?
与えられた predicate (述語) を満たすシーケンスの最後の要素を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
func lastIndex(of: Bound) -> Bound?
指定された値がコレクションに現れる最後のインデックスを返します。
Element が Equatable に準拠している場合に使用可能です。
func lastIndex(where: (Bound) -> Bool) -> Bound?
与えられた predicate (述語) に一致するコレクション内の最後の要素のインデックスを返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
シーケンス内の最小要素を返します。
Element が Comparable に準拠している場合使用可能です。
func min(by: (Bound, Bound) -> Bool) -> Bound?
与えられた predicate (述語) を要素間の比較として使用して、シーケンス内の最小要素を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。
シーケンス内の最大要素を返します。
Element が Comparable に準拠している場合使用可能です。
func max(by: (Bound, Bound) -> Bool) -> Bound?
与えられた predicate (述語) を要素間の比較として使用して、シーケンス内の最大要素を返します。
Bound が Strideable に準拠し、Bound.Stride が SignedInteger に準拠する場合に使用可能です。