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

filter(_:)

Creates an asynchronous sequence that contains, in order, the elements of the base sequence that satisfy the given error-throwing predicate. ある非同期シーケンスを作成します、それは基底シーケンスの要素それらを、順番に含みます、それらは与えられたエラースロー述部を満たすものです。

Declaration 宣言

func filter(_ isIncluded: @escaping (Self.Element) async throws -> Bool) -> AsyncThrowingFilterSequence<Self>

Parameters パラメータ

isIncluded: An error-throwing closure that takes an element of the asynchronous sequence as its argument and returns a Boolean value that indicates whether to include the element in the filtered sequence. あるエラースロークロージャ、それは非同期シーケンスの１つの要素をそれの引数として取り、その要素をこの平坦化されたシーケンスに含むことになるかどうかを指し示すブール値を返します。

Return Value 戻り値

An asynchronous sequence that contains, in order, the elements of the base sequence that satisfy the given predicate. If the predicate throws an error, the sequence contains only values produced prior to the error. ある非同期シーケンス、それは基底シーケンスの要素それらを、順番に含みます、それらは与えられた述部を満たすものです。述部がエラーをスローするならば、シーケンスはエラーより前に生み出された値のみを含みます。

Discussion 解説

In this example, an asynchronous sequence called Counter produces Int values from 1 to 10. The filter(_:) method returns true for even values and false for odd values, thereby filtering out the odd values, but also throws an error for values divisible by 5: この例において、Counterと呼ばれる非同期シーケンスはInt値を1から10まで生み出します。filter(_:)メソッドは、trueを偶数値に対してそしてfalseを奇数値に対して返します、それによって奇数値を取り除いています、しかしまた５で割り切れる値に対してエラーをスローします：

do {
    let stream =  Counter(howHigh: 10)
        .filter {
            if $0 % 5 == 0 {
                throw MyError()
            }
            return $0 % 2 == 0
        }
    for try await number in stream {
        print("\(number) ", terminator: " ")
    }
} catch {
    print("Error: \(error)")
}
// Prints: 2  4  Error: MyError()

See Also 参照

Excluding Elements 要素を除外する

func dropFirst(Int) -> AsyncDropFirstSequence<Self>

Omits a specified number of elements from the base asynchronous sequence, then passes through all remaining elements. 指定された数の要素を基底非同期シーケンスから除きます、それから全ての残りの要素をずっと渡します。

struct AsyncDropFirstSequence

An asynchronous sequence which omits a specified number of elements from the base asynchronous sequence, then passes through all remaining elements. ある非同期シーケンス、それは指定された数の要素を基底非同期シーケンスから省きます、それから全ての残りの要素をずっと渡します。

func drop(while: (Self.Element) -> Bool) -> AsyncDropWhileSequence<Self>

Omits elements from the base asynchronous sequence until a given closure returns false, after which it passes through all remaining elements. 要素を基底非同期シーケンスから、ある与えられたクロージャがfalseを返すまで省きます、それの後それは全ての残りの要素をずっと渡します。

struct AsyncDropWhileSequence

An asynchronous sequence which omits elements from the base sequence until a given closure returns false, after which it passes through all remaining elements. ある非同期シーケンス、それは要素を基底シーケンスから、ある与えられたクロージャがfalseを返すまで省きます、それの後それは全ての残りの要素をずっと渡します。

func drop(while: (Self.Element) -> Bool) -> AsyncThrowingDropWhileSequence<Self>

Omits elements from the base sequence until a given error-throwing closure returns false, after which it passes through all remaining elements. 要素を基底シーケンスから、ある与えられたエラースロークロージャがfalseを返すまで省きます、それの後それは全ての残りの要素をずっと渡します。

struct AsyncThrowingDropWhileSequence

An asynchronous sequence which omits elements from the base sequence until a given error-throwing closure returns false, after which it passes through all remaining elements. ある非同期シーケンス、それは要素を基底シーケンスから、ある与えられたエラースロークロージャがfalseを返すまで省きます、それの後それは全ての残りの要素をずっと渡します。

func filter((Self.Element) -> Bool) -> AsyncFilterSequence<Self>

Creates an asynchronous sequence that contains, in order, the elements of the base sequence that satisfy the given predicate. ある非同期シーケンスを作成します、それは基底シーケンスの要素それらを、順番に含みます、それらは与えられた述部を満たすものです。

struct AsyncFilterSequence

An asynchronous sequence that contains, in order, the elements of the base sequence that satisfy a given predicate. ある非同期シーケンス、それは基底シーケンスの要素それらを、順番に含みます、それらは与えられた述部を満たすものです。

struct AsyncThrowingFilterSequence

An asynchronous sequence that contains, in order, the elements of the base sequence that satisfy the given error-throwing predicate. ある非同期シーケンス、それは基底シーケンスの要素それらを、順番に含みます、それらは与えられたエラースロー述部を満たすものです。