Enclose: Difference between revisions

Jump to navigation Jump to search
478 bytes added ,  21:29, 14 July 2020
→‎Description: Clarify enclosing a simple scalar: it's always allowed but might not do anything
(→‎Description: Clarify enclosing a simple scalar: it's always allowed but might not do anything)
(3 intermediate revisions by one other user not shown)
Line 55: Line 55:
== Description ==
== Description ==


Some implementations allow a [[simple]] [[scalar]] to be [[box]]ed, while the others do not.
With no [[function axis]], Enclose returns a [[scalar]] array whose only [[element]] is the argument. In the [[flat array model]] this means that the argument is placed in a [[box]], and the result is this box as a scalar. In the [[nested array model]] it can simply be viewed as creating a new array. However, if the argument is a [[simple scalar]], then the result will match the argument because nested array theory dicatates that simple scalars [[float]].


Enclose (without axis) is a right inverse to [[Mix]] and [[First]].
== Properties ==
 
Enclose (without axis) is the [[inverse]] of both [[Mix]] and [[First]] in the sense that either of these undoes the additional nesting introduced by Enclose.


== External links ==
== External links ==
Line 63: Line 65:
=== Documentation ===
=== Documentation ===


* [http://help.dyalog.com/latest/#Language/Primitive%20Functions/Enclose.htm Dyalog], [http://help.dyalog.com/latest/#Language/Primitive%20Functions/Enclose%20with%20Axes.htm with axes]
* [https://help.dyalog.com/latest/#Language/Primitive%20Functions/Enclose.htm Dyalog], [https://help.dyalog.com/latest/#Language/Primitive%20Functions/Enclose%20with%20Axes.htm with axes]
* [http://microapl.com/apl_help/ch_020_020_580.htm APLX]
* [http://microapl.com/apl_help/ch_020_020_580.htm APLX]
* J [https://www.jsoftware.com/help/dictionary/d010.htm Vocabulary], [https://code.jsoftware.com/wiki/Vocabulary/lt NuVoc]
* J [https://www.jsoftware.com/help/dictionary/d010.htm Vocabulary], [https://code.jsoftware.com/wiki/Vocabulary/lt NuVoc]


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

Navigation menu