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) ==
  
(stub: Needs to be filled in)
+
Returns the «n»th slice of array «A» along index «I».
  
New to 4.0: slice(A,I,x) can be written as [[@ operator|''A[@I=x]'']].
+
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) &rarr; 1</code>
 +
:<code>Slice(A, J, 3..6) &rarr; [3, 4, 1, 9]</code>
 +
:<code>Slice(A, J, K) &rarr; Array(J, [9, 2, 3])</code>
 +
:<code>Slice(A, J, 9) &rarr; «null»  {with an out-of-range warning}</code>
 +
:<code>Slice(A, I, 3) &rarr; Array(J, [9, 2, 3, 4, 1, 9, 0, 3])</code>
 +
 
 +
:<code>Slice(B, I, 3) &rarr; Array(K,[31, 32, 33])</code>
 +
:<code>Slice(B, K, 3) &rarr; Array(I,[13, 23, 33, 43])</code>
 +
 
 +
:<code>Slice(4, J, 5) &rarr; 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


You are not allowed to post comments.