Difference between revisions of "Slice"
(→Examples: Fixed out of range example, before it wasn't returning null) |
|||
(9 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:Functions that select part of an array]] | [[Category:Functions that select part of an array]] | ||
+ | |||
+ | == Slice(A, I, n) == | ||
− | + | Returns the «n»th slice of array «A» along index «I». | |
− | + | The [[Slice]] function is so commonly used, as is its associational counterpart, the [[Subscript]] function, that a special shorthand notation is more often used in Analytica expressions. <code>Slice(A, I, n)</code> can be written as [[Subscript-Slice Operator|A[@I = n]]]. | |
+ | |||
+ | == Slice(A, n) == | ||
+ | |||
+ | When «A» is one-dimensional, «I» can be omitted. Use this syntax when you want to obtain the «n»th element of a list, but cannot name the index since it is implicit. | ||
+ | |||
+ | == Library == | ||
+ | |||
+ | Array functions | ||
+ | |||
+ | == Examples == | ||
+ | :<code>Index I := [10, 20, 30, 40]</code> | ||
+ | :<code>Index J := ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h']</code> | ||
+ | :<code>Index K := 1..3</code> | ||
+ | :<code>Variable A := Table(J)(9, 2, 3, 4, 1, 9, 0, 3)</code> | ||
+ | :<code>Variable B := I + K</code> | ||
+ | |||
+ | :<code>Slice(A, J, 5) → 1</code> | ||
+ | :<code>Slice(A, J, 3..6) → [3, 4, 1, 9]</code> | ||
+ | :<code>Slice(A, J, K) → Array(J, [9, 2, 3])</code> | ||
+ | :<code>Slice(A, J, 9) → «null» {with an out-of-range warning}</code> | ||
+ | :<code>Slice(A, I, 3) → Array(J, [9, 2, 3, 4, 1, 9, 0, 3])</code> | ||
+ | |||
+ | :<code>Slice(B, I, 3) → Array(K,[31, 32, 33])</code> | ||
+ | :<code>Slice(B, K, 3) → Array(I,[13, 23, 33, 43])</code> | ||
+ | |||
+ | :<code>Slice(4, J, 5) → 4</code> | ||
+ | |||
+ | == See Also == | ||
+ | * [[Arrays and Indexes]] | ||
+ | * [[Slice assignment]] | ||
+ | * [[Subscript-Slice Operator]] | ||
+ | * [[Subscript]] | ||
+ | * [[Subscript and slice of a subarray]] | ||
+ | * [[Table Splicing]] |
Latest revision as of 07:47, 7 May 2025
Slice(A, I, n)
Returns the «n»th slice of array «A» along index «I».
The Slice function is so commonly used, as is its associational counterpart, the Subscript function, that a special shorthand notation is more often used in Analytica expressions. Slice(A, I, n)
can be written as A[@I = n].
Slice(A, n)
When «A» is one-dimensional, «I» can be omitted. Use this syntax when you want to obtain the «n»th element of a list, but cannot name the index since it is implicit.
Library
Array functions
Examples
Index I := [10, 20, 30, 40]
Index J := ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h']
Index K := 1..3
Variable A := Table(J)(9, 2, 3, 4, 1, 9, 0, 3)
Variable B := I + K
Slice(A, J, 5) → 1
Slice(A, J, 3..6) → [3, 4, 1, 9]
Slice(A, J, K) → Array(J, [9, 2, 3])
Slice(A, J, 9) → «null» {with an out-of-range warning}
Slice(A, I, 3) → Array(J, [9, 2, 3, 4, 1, 9, 0, 3])
Slice(B, I, 3) → Array(K,[31, 32, 33])
Slice(B, K, 3) → Array(I,[13, 23, 33, 43])
Slice(4, J, 5) → 4
See Also
Comments
Enable comment auto-refresher