Assignment: Difference between revisions

From APL Wiki
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "</source>" to "</syntaxhighlight>")
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Built-in|Assignment|←}} allows associating a name with an [[array]] value. Some dialects also allow assignment of function and operator values using the assignment arrow. In [[defined functions]], assignment is global by default, but can be made local through explicit mention of the target name in the function header, or through dynamic [[shadow]]ing using <source lang=apl inline>⎕SHADOW</source>. In [[dfn]]s, assignments are local by default, but can be made global by explicit mention of the target namespace. Modified/indexed/selective assignment updates the most local definition.
{{Built-in|Assignment|←}} allows associating a name with an [[array]] value. Some dialects also allow assignment of function and operator values using the assignment arrow. In [[defined functions]], assignment is global by default, but can be made local through explicit mention of the target name in the function header, or through dynamic [[shadow]]ing using <syntaxhighlight lang=apl inline>⎕SHADOW</syntaxhighlight>. In [[dfn]]s, assignments are local by default, but can be made global by explicit mention of the target namespace. Modified/indexed/selective assignment updates the most local definition.
==Examples==
==Examples==
===Basic usage===
===Basic usage===
Common examples (boxing on, and [[index origin]] is 0):
Common examples (boxing on, and [[index origin]] is 0):
<source lang=apl>
<syntaxhighlight lang=apl>
  ⎕←mat←(1 2 3)(1 2 3)
      ⎕←mat←(1 2 3)(1 2 3)
┌─────┬─────┐
┌─────┬─────┐
│1 2 3│1 2 3│
│1 2 3│1 2 3│
└─────┴─────┘
└─────┴─────┘
</source>
</syntaxhighlight>
===Indexed assignment===
===Indexed assignment===
Individual elements can be updated using index assignment:
Individual elements can be updated using index assignment:
<source lang=apl>
<syntaxhighlight lang=apl>
  mat[0]←1
      mat[0]←1
  mat
      mat
┌─┬─────┐
┌─┬─────┐
│1│1 2 3│
│1│1 2 3│
└─┴─────┘
└─┴─────┘
</source>
</syntaxhighlight>
A semicolon is necessary when dealing with a [[matrix]]:
A semicolon is necessary when dealing with a [[matrix]]:
<source lang=apl>
<syntaxhighlight lang=apl>
  mat←3 3⍴⍳9
      mat←3 3⍴⍳9
  mat
      mat
0 1 2
0 1 2
3 4 5
3 4 5
6 7 8
6 7 8
  mat[0 1;]
      mat[0 1;]
0 1 2
0 1 2
3 4 5
3 4 5
  mat[0 1;0 1]←0
      mat[0 1;0 1]←0
  mat
      mat
0 0 2
0 0 2
0 0 5
0 0 5
6 7 8
6 7 8
</source>
</syntaxhighlight>
For higher-[[rank]] arrays, the number of semicolons needed is one less than the array rank.
For higher-[[rank]] arrays, the number of semicolons needed is one less than the array rank.
===Modified assignment===
===Modified assignment===
Some dialects allow placing a function the the immediate left of the assignment arrow:
Some dialects allow placing a function the the immediate left of the assignment arrow:
<source lang=apl>
<syntaxhighlight lang=apl>
  var←42
      var←42
  var+←1
      var+←1
  var
      var
43
43
</source>
</syntaxhighlight>
<source lang=apl inline>var+←1</source> is essentially equivalent to <source lang=apl inline>1⊣var←var+1</source> except that the result is [[shy]].
<syntaxhighlight lang=apl inline>var+←1</syntaxhighlight> is essentially equivalent to <syntaxhighlight lang=apl inline>1⊣var←var+1</syntaxhighlight> except that the result is [[shy]].
===Modified indexed assignment===
===Modified indexed assignment===
Modified assignment can also be combined with indexed assignment:
Modified assignment can also be combined with indexed assignment:
<source lang=apl>
<syntaxhighlight lang=apl>
  mat←3 3⍴0
      mat←3 3⍴0
  mat
      mat
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
  mat[0 1;1]+←1
      mat[0 1;1]+←1
  mat
      mat
0 1 0
0 1 0
0 1 0
0 1 0
0 0 0
0 0 0
  mat[1;1],←'x'
      mat[1;1],←'x'
  mat
      mat
0 1 0
0 1 0
0 x 0
0 x 0
0 0 0
0 0 0
</source>
</syntaxhighlight>
== External Links ==
== External Links ==



Latest revision as of 22:12, 10 September 2022

Assignment () allows associating a name with an array value. Some dialects also allow assignment of function and operator values using the assignment arrow. In defined functions, assignment is global by default, but can be made local through explicit mention of the target name in the function header, or through dynamic shadowing using ⎕SHADOW. In dfns, assignments are local by default, but can be made global by explicit mention of the target namespace. Modified/indexed/selective assignment updates the most local definition.

Examples

Basic usage

Common examples (boxing on, and index origin is 0):

      mat(1 2 3)(1 2 3)
┌─────┬─────┐
1 2 31 2 3
└─────┴─────┘

Indexed assignment

Individual elements can be updated using index assignment:

      mat[0]1
      mat
┌─┬─────┐
11 2 3
└─┴─────┘

A semicolon is necessary when dealing with a matrix:

      mat3 3⍴⍳9
      mat
0 1 2
3 4 5
6 7 8
      mat[0 1;]
0 1 2
3 4 5
      mat[0 1;0 1]0
      mat
0 0 2
0 0 5
6 7 8

For higher-rank arrays, the number of semicolons needed is one less than the array rank.

Modified assignment

Some dialects allow placing a function the the immediate left of the assignment arrow:

      var42
      var+1
      var
43

var+1 is essentially equivalent to 1varvar+1 except that the result is shy.

Modified indexed assignment

Modified assignment can also be combined with indexed assignment:

      mat3 30
      mat
0 0 0
0 0 0
0 0 0
      mat[0 1;1]+1
      mat
0 1 0
0 1 0
0 0 0
      mat[1;1],'x'
      mat
0 1 0
0 x 0
0 0 0

External Links

Documentation

APL built-ins [edit]
Primitive functions
Scalar
Monadic ConjugateNegateSignumReciprocalMagnitudeExponentialNatural LogarithmFloorCeilingFactorialNotPi TimesRollTypeImaginarySquare Root
Dyadic AddSubtractTimesDivideResiduePowerLogarithmMinimumMaximumBinomialComparison functionsBoolean functions (And, Or, Nand, Nor) ∙ GCDLCMCircularComplexRoot
Non-Scalar
Structural ShapeReshapeTallyDepthRavelEnlistTableCatenateReverseRotateTransposeRazeMixSplitEncloseNestCut (K)PairLinkPartitioned EnclosePartition
Selection FirstPickTakeDropUniqueIdentitySelectReplicateExpandSet functions (IntersectionUnionWithout) ∙ Bracket indexingIndex
Selector Index generatorGradeIndex OfInterval IndexIndicesDeal
Computational MatchNot MatchMembershipFindNub SieveEncodeDecodeMatrix InverseMatrix DivideFormatExecuteMaterialiseRange
Primitive operators Monadic EachCommuteConstantReplicateExpandReduceWindowed ReduceScanOuter ProductKeyI-BeamSpawnFunction axis
Dyadic BindCompositions (Compose, Reverse Compose, Beside, Withe, Atop, Over) ∙ Inner ProductPowerAtUnderRankDepthVariantStencilCut (J)
Quad names
Arrays Index originMigration levelAtomic vector
Functions Name classCase convertUnicode convert
Operators SearchReplace