Difference between revisions of "Shape"
m (Text replacement  "http://help.dyalog.com" to "https://help.dyalog.com") 

Line 30:  Line 30:  
=== Documentation ===  === Documentation ===  
−  * [  +  * [https://help.dyalog.com/latest/index.htm#Language/Primitive%20Functions/Shape.htm Dyalog] 
* [http://wiki.nars2000.org/index.php/Rho NARS2000]  * [http://wiki.nars2000.org/index.php/Rho NARS2000]  
* [http://microapl.com/apl_help/ch_020_020_460.htm APLX]  * [http://microapl.com/apl_help/ch_020_020_460.htm APLX] 
Latest revision as of 14:42, 14 July 2020
⍴

Shape (⍴
) is a monadic function which returns the shape of its argument array, namely a vector of lengths of the array along each axis. The dyadic function using the same symbol is Reshape which produces an array of the shape specified by its left argument.
An array's shape may be any vector of nonnegative integers with length less than or equal to the maximum rank. The length of an array's shape is the array's rank, and the product of the shape is its bound. If the shape is empty then the array is a scalar.
An array's shape, along with the index origin, determine the possible values which can be used as an index into the array. A complete index is a vector of integers with the same length as the shape. When the index origin is subtracted from the index each element must be at least 0 and less than the corresponding element of the shape. In languages with negative indexing it may be greater than or equal to the negative of the shape rather than 0.
Examples
(⍬≡⍴)¨1 'A' ⍝ The shape of a scalar is the empty numeric vector ⍬
1 1
⍴'ABCDE' ⍝ The shape of a vector is a length1 vector
5
⍴'ABC'∘.,1 2 3 4 ⍝ The shape of the matrix result of an outer product
3 4
⍴'ABC'∘.,1 2 3 4∘.×0J1 1J2 ⍝ Two consecutive outer products result in a cuboid
3 4 2
See also
External links
Lessons
Documentation
 Dyalog
 NARS2000
 APLX
 J Dictionary, J NuVoc (as
$
"Shape Of")
APL features [edit]  

Builtins  Primitive function ∙ Primitive operator ∙ Quad name 
Array model  Shape ∙ Rank ∙ Depth ∙ Bound ∙ Index (Indexing) ∙ Axis ∙ Ravel ∙ Ravel order ∙ Element ∙ Scalar ∙ Vector ∙ Matrix ∙ Simple scalar ∙ Simple array ∙ Nested array ∙ Cell ∙ Major cell ∙ Subarray ∙ Empty array ∙ Prototype 
Data types  Number (Boolean, Complex number) ∙ Character (String) ∙ Box ∙ Namespace 
Concepts and paradigms  Leading axis theory ∙ Scalar extension ∙ Conformability ∙ Scalar function ∙ Pervasion ∙ Glyph ∙ Identity element ∙ Complex floor ∙ Total array ordering 
Errors  LIMIT ERROR ∙ RANK ERROR ∙ SYNTAX ERROR ∙ DOMAIN ERROR ∙ LENGTH ERROR ∙ INDEX ERROR ∙ VALUE ERROR 