Pick: Difference between revisions

From APL Wiki
Jump to navigation Jump to search
(Created page with "{{Built-in|Pick|⊃}} is a dyadic primitive function which performs deep indexing on a possibly nested array. Pick allows to extract a value through multiple l...")
 
m (Text replacement - "http://help.dyalog.com" to "https://help.dyalog.com")
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Built-in|Pick|⊃}} is a [[dyadic]] [[primitive function]] which performs deep [[indexing]] on a possibly [[nested array]]. Pick allows to extract a value through multiple layers of nesting in a single function application. Pick shares the [[glyph]] <source lang=apl inline>⊃</source> with [[First]] or [[Mix]] depending on the dialect.
{{Built-in|Pick|⊃}} is a [[dyadic]] [[primitive function]] which performs deep [[indexing]] on a possibly [[nested array]]. Pick allows to extract a value through multiple layers of nesting in a single function application. Pick uses the [[Right Shoe]] glyph.


== Examples ==
== Examples ==
Line 6: Line 6:


<source lang=apl>
<source lang=apl>
       ⊢G←2 3⍴('ABC' 1)('DEF' 2)('GHI' 3)('JKL' 4)('MNO' 5)('PQR' 6)
       ⎕←G←2 3⍴('ABC' 1)('DEF' 2)('GHI' 3)('JKL' 4)('MNO' 5)('PQR' 6)
┌───────┬───────┬───────┐
┌───────┬───────┬───────┐
│┌───┬─┐│┌───┬─┐│┌───┬─┐│
│┌───┬─┐│┌───┬─┐│┌───┬─┐│
Line 25: Line 25:
K
K
</source>
</source>
== See also ==
* [[Index (function)]]
* [[Bracket indexing]]
* [[Select]]


== External links ==
== External links ==
Line 30: Line 35:
=== Documentation ===
=== Documentation ===


* [http://help.dyalog.com/latest/#Language/Primitive%20Functions/Pick.htm Dyalog]
* [https://help.dyalog.com/latest/#Language/Primitive%20Functions/Pick.htm Dyalog]
* [http://microapl.com/apl_help/ch_020_020_610.htm APLX]
* [http://microapl.com/apl_help/ch_020_020_610.htm APLX]


{{APL built-ins}}[[Category:Primitive functions]]
{{APL built-ins}}[[Category:Primitive functions]]

Revision as of 14:33, 14 July 2020

⊃

Pick (⊃) is a dyadic primitive function which performs deep indexing on a possibly nested array. Pick allows to extract a value through multiple layers of nesting in a single function application. Pick uses the Right Shoe glyph.

Examples

The left argument X must be a vector where each element of X specifies the multi-dimensional index at each layer of the right argument Y. The result of X⊃Y is the item of Y at the location specified by X. 

      ⎕←G←2 3⍴('ABC' 1)('DEF' 2)('GHI' 3)('JKL' 4)('MNO' 5)('PQR' 6)
┌───────┬───────┬───────┐
│┌───┬─┐│┌───┬─┐│┌───┬─┐│
││ABC│1│││DEF│2│││GHI│3││
│└───┴─┘│└───┴─┘│└───┴─┘│
├───────┼───────┼───────┤
│┌───┬─┐│┌───┬─┐│┌───┬─┐│
││JKL│4│││MNO│5│││PQR│6││
│└───┴─┘│└───┴─┘│└───┴─┘│
└───────┴───────┴───────┘
      (⊂2 1)⊃G
┌───┬─┐
│JKL│4│
└───┴─┘
      ((2 1)1)⊃G
JKL
      ((2 1)1 2)⊃G
K

See also

External links

Documentation


APL built-ins [edit]
Primitives (Timeline) Functions
Scalar
Monadic Conjugate ∙ Negate ∙ Signum ∙ Reciprocal ∙ Magnitude ∙ Exponential ∙ Natural Logarithm ∙ Floor ∙ Ceiling ∙ Factorial ∙ Not ∙ Pi Times ∙ Roll ∙ Type ∙ Imaginary ∙ Square Root
Dyadic Add ∙ Subtract ∙ Times ∙ Divide ∙ Residue ∙ Power ∙ Logarithm ∙ Minimum ∙ Maximum ∙ Binomial ∙ Comparison functions ∙ Boolean functions (And, Or, Nand, Nor) ∙ GCD ∙ LCM ∙ Circular ∙ Complex ∙ Root
Non-Scalar
Structural Shape ∙ Reshape ∙ Tally ∙ Depth ∙ Ravel ∙ Enlist ∙ Table ∙ Catenate ∙ Reverse ∙ Rotate ∙ Transpose ∙ Raze ∙ Mix ∙ Split ∙ Enclose ∙ Nest ∙ Cut (K) ∙ Pair ∙ Link ∙ Partitioned Enclose ∙ Partition
Selection First ∙ Pick ∙ Take ∙ Drop ∙ Unique ∙ Identity ∙ Stop ∙ Select ∙ Replicate ∙ Expand ∙ Set functions (Intersection ∙ Union ∙ Without) ∙ Bracket indexing ∙ Index ∙ Cartesian Product ∙ Sort
Selector Index generator ∙ Grade ∙ Index Of ∙ Interval Index ∙ Indices ∙ Deal ∙ Prefix and suffix vectors
Computational Match ∙ Not Match ∙ Membership ∙ Find ∙ Nub Sieve ∙ Encode ∙ Decode ∙ Matrix Inverse ∙ Matrix Divide ∙ Format ∙ Execute ∙ Materialise ∙ Range
Operators Monadic Each ∙ Commute ∙ Constant ∙ Replicate ∙ Expand ∙ Reduce ∙ Windowed Reduce ∙ Scan ∙ Outer Product ∙ Key ∙ I-Beam ∙ Spawn ∙ Function axis
Dyadic Bind ∙ Compositions (Compose, Reverse Compose, Beside, Withe, Atop, Over) ∙ Inner Product ∙ Determinant ∙ Power ∙ At ∙ Under ∙ Rank ∙ Depth ∙ Variant ∙ Stencil ∙ Cut ∙ Direct definition (operator)
Quad names Index origin ∙ Comparison tolerance ∙ Migration level ∙ Atomic vector
Retrieved from ‘https://aplwiki.com/index.php?title=Pick&oldid=5163’