1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
|
class:: Pselect
summary:: Filters values returned by a source pattern.
categories:: Streams-Patterns-Events>Patterns>Filter
related:: Classes/Pcollect, Classes/Preject, Classes/Collection#-select
description::
This pattern will filter the source pattern using the supplied function strong::func::.
Values from the source pattern will be passed to strong::func::. Pselect will only return that value if the strong::func:: returns true.
This is the pattern library's equivalent of link::Classes/Collection#-select#select::.
classmethods::
method:: new
argument:: func
A link::Classes/Function:: that takes one parameter (the next value from strong::pattern::) and returns a boolean.
argument:: pattern
The source link::Classes/Pattern::.
examples::
code::
(
var a, b;
a = Pselect({ arg item; item != 2 }, Pseq(#[1, 2, 3],inf));
x = a.asStream;
9.do({ x.next.postln; });
)
::
The message code::select:: returns a Pselect when passed to a pattern.
code::
(
var a, b;
a = Pseq(#[1, 2, 3],inf).select({ arg item; item != 2 });
a.postln;
x = a.asStream;
9.do({ x.next.postln; });
)
::
|