Atop (operator): Difference between revisions
(Created page with "{{Built-in|Atop|⍤}} is a primitive dyadic operator which takes two function operands and produces a derived function which uses the le...") |
m (→Explanation: added missing parenthesis) |
||
(3 intermediate revisions by one other user not shown) | |||
Line 8: | Line 8: | ||
When the resulting function is used [[dyadic]]ally, the result is post-processed: | When the resulting function is used [[dyadic]]ally, the result is post-processed: | ||
{| | {| | ||
|<source lang=apl>⍺ (g ⍤ h) ⍵</source>|| {{←→}} ||<source lang=apl>g ⍺ h ⍵)</source> | |<source lang=apl>⍺ (g ⍤ h) ⍵</source>|| {{←→}} ||<source lang=apl>g (⍺ h ⍵)</source> | ||
|} | |} | ||
Line 21: | Line 21: | ||
¯4 ¯6 ¯5 | ¯4 ¯6 ¯5 | ||
</source> | </source> | ||
== Close composition == | |||
In [[SHARP APL]] and [[J]], Atop is implemented as a [[close composition]], meaning that (using SHARP syntax) <source lang=apl inline>f⍥g</source> has the overall [[function rank]] of <source lang=apl inline>g</source>. J uses <code>@</code> for the close form and <code>@:</code> for the rankless form that appears in modern APLs. | |||
== History == | |||
Atop was defined as subordinate to [[Over]] in [[Ken Iverson]]'s 1978 paper [[Operators and Functions]]: that is, the derived function <source lang=apl inline>f¨g</source> works as an Atop if <source lang=apl inline>f</source> is strictly monadic or (in the dyadic case) <source lang=apl inline>g</source> is strictly dyadic. He called it Composition, as there was no [[Atop operator]]. It was added to [[SHARP APL]] as a [[close composition]] with glyph <source lang=apl inline>⍥</source> and name "upon" (initially "over"), with a limited implementation in 1981<ref>[https://www.jsoftware.com/papers/satn41.htm "Composition and Enclosure"]. SATN-41, 1981-06-20.</ref> followed by a full implementation in 1983 with the introduction of [[function rank]].<ref>[https://www.jsoftware.com/papers/satn45.htm "Language Extensions of May 1983"]. SATN-45, 1983-05-02.</ref> The name "Atop" was introduced by [[J]] (which uses "At" for its non-close form). The glyph <source lang=apl inline>⍤</source> was chosen for [[Dyalog APL 18.0]], shared with the [[Rank operator]]. | |||
== External links == | == External links == | ||
=== Lessons === | === Lessons === | ||
Line 27: | Line 36: | ||
* [https://help.dyalog.com/latest/#Language/Primitive%20Operators/Atop.htm Dyalog] | * [https://help.dyalog.com/latest/#Language/Primitive%20Operators/Atop.htm Dyalog] | ||
* J [https://www.jsoftware.com/help/dictionary/d632.htm Dictionary], [https://code.jsoftware.com/wiki/Vocabulary/atco NuVoc] | * J [https://www.jsoftware.com/help/dictionary/d632.htm Dictionary], [https://code.jsoftware.com/wiki/Vocabulary/atco NuVoc] | ||
* [https://mlochbaum.github.io/BQN/doc/compose.html BQN] | |||
{{APL built-ins}}[[Category:Primitive operators]][[Category:Composition operators]] | {{APL built-ins}}[[Category:Primitive operators]][[Category:Composition operators]] |
Revision as of 23:37, 19 June 2022
⍤
|
Atop (⍤
) is a primitive dyadic operator which takes two function operands and produces a derived function which uses the left operand monadically to post-processes the result of the ambivalent right operand.
Explanation
When the resulting function is used monadically, it has the same behaviour as if the Atop 2-train or any of the Beside or Over operators had been used:
(g ⍤ h) ⍵ |
g (h ⍵) |
When the resulting function is used dyadically, the result is post-processed:
⍺ (g ⍤ h) ⍵ |
g (⍺ h ⍵) |
Examples
x←3 1 2 y←4 6 5 x -⍤⌈ y ⍝ the negation of the max of x y ¯4 ¯6 ¯5 ⍝ same as -x⌈y ¯4 ¯6 ¯5
Close composition
In SHARP APL and J, Atop is implemented as a close composition, meaning that (using SHARP syntax) f⍥g
has the overall function rank of g
. J uses @
for the close form and @:
for the rankless form that appears in modern APLs.
History
Atop was defined as subordinate to Over in Ken Iverson's 1978 paper Operators and Functions: that is, the derived function f¨g
works as an Atop if f
is strictly monadic or (in the dyadic case) g
is strictly dyadic. He called it Composition, as there was no Atop operator. It was added to SHARP APL as a close composition with glyph ⍥
and name "upon" (initially "over"), with a limited implementation in 1981[1] followed by a full implementation in 1983 with the introduction of function rank.[2] The name "Atop" was introduced by J (which uses "At" for its non-close form). The glyph ⍤
was chosen for Dyalog APL 18.0, shared with the Rank operator.
External links
Lessons
Documentation
- Dyalog
- J Dictionary, NuVoc
- BQN
- ↑ "Composition and Enclosure". SATN-41, 1981-06-20.
- ↑ "Language Extensions of May 1983". SATN-45, 1983-05-02.