Index origin: Difference between revisions
Miraheze>Marshall (Created page with "The index origin is the number used for the first index along each axis of an array. Many APLs allow the user to configure index origin using the system variable <...") |
Miraheze>Marshall No edit summary |
||
| Line 14: | Line 14: | ||
The choice of which numbers are indices is subjective and must be made by the language designer. In some cases there is no clear decision: [[Interval Index]] and [[Occurrence Count]] each have natural definitions that depend on index origin, and natural definitions that do not. | The choice of which numbers are indices is subjective and must be made by the language designer. In some cases there is no clear decision: [[Interval Index]] and [[Occurrence Count]] each have natural definitions that depend on index origin, and natural definitions that do not. | ||
== Functions which depend on index origin == | |||
The following functions depend on <code>⎕IO</code> in at least some APLs. They are listed with the [[glyphs]] used for them in [[Dyalog APL]]. For functions, only the result depends on <code>⎕IO</code> except where noted with <code>⍺</code> in which case the left argument does instead. For operators the dependence is noted. | |||
{| class="wikitable c" style="margin:1em auto" | |||
! [[Monadic functions]] !! [[Dyadic functions]] !! [[Operators]] | |||
|- | |||
| [[Iota]] (<code>⍳</code>) || [[Index-Of]] (<code>⍳</code>) || [[Key]] (<code>⌸</code>) argument to <code>⍺⍺</code> | |||
|- | |||
| [[Roll]] (<code>?</code>) || [[Roll]] (<code>?</code>) || [[At]] (<code>@</code>) result of <code>⍵⍵</code> | |||
|- | |||
| [[Grade]] (<code>⍒⍋</code>) || (<code>⍒⍋</code>) || | |||
|- | |||
| [[Indices]] (<code>⍸</code>) || [[Interval Index]] (<code>⍸</code>) || | |||
|- | |||
| || [[Transpose]] (<code>⍉</code>) <code>⍺</code> || | |||
|- | |||
| || [[Pick]] (<code>⊃</code>) <code>⍺</code> || | |||
|- | |||
| || [[Squad]] (<code>⌷</code>) <code>⍺</code> || | |||
|} | |||
Additionally, [[indexing]] with brackets and [[axis specification]] depend on index origin. | |||
== External links == | == External links == | ||
Revision as of 14:56, 17 October 2019
The index origin is the number used for the first index along each axis of an array. Many APLs allow the user to configure index origin using the system variable ⎕IO. Even array languages which do not have such a configuration parameter must make a choice of index origin; for example, J uses a non-configurable index origin of 0. The English language uses an index origin of one: thus the element with index ⎕IO in APL is referred to in English as the "first" element.
The index origin affects both the handling of index arguments to functions (and other functionality like axis specification) and their results. For example, Iota (or "Index Generator") creates results which begin with ⎕IO.
⎕IO←0
⍳4
0 1 2 3
⎕IO←1
⍳4
1 2 3 4
Any number could consistently be used for the index origin, but almost all APLs restrict the choice to 0 or 1. ngn/apl supports ⎕IO but only allows it to have the value 0. Attempting to assign an unsupported value to ⎕IO typically results in a DOMAIN ERROR.
The choice of which numbers are indices is subjective and must be made by the language designer. In some cases there is no clear decision: Interval Index and Occurrence Count each have natural definitions that depend on index origin, and natural definitions that do not.
Functions which depend on index origin
The following functions depend on ⎕IO in at least some APLs. They are listed with the glyphs used for them in Dyalog APL. For functions, only the result depends on ⎕IO except where noted with ⍺ in which case the left argument does instead. For operators the dependence is noted.
| Monadic functions | Dyadic functions | Operators |
|---|---|---|
Iota (⍳) |
Index-Of (⍳) |
Key (⌸) argument to ⍺⍺
|
Roll (?) |
Roll (?) |
At (@) result of ⍵⍵
|
Grade (⍒⍋) |
(⍒⍋) |
|
Indices (⍸) |
Interval Index (⍸) |
|
Transpose (⍉) ⍺ |
||
Pick (⊃) ⍺ |
||
Squad (⌷) ⍺ |
Additionally, indexing with brackets and axis specification depend on index origin.