Format: Difference between revisions

From APL Wiki
Jump to navigation Jump to search
m (Text replacement - "http://help.dyalog.com" to "https://help.dyalog.com")
m (Text replacement - "<source" to "<syntaxhighlight")
Line 5: Line 5:
=== Monadic form ===
=== Monadic form ===


Format in its [[monadic]] form allows the user to convert [[Array model|arrays]] of any [[type]] into simple character arrays (for example for concatenation with other character arrays). The result usually matches the interpreter's default display, either by <source lang=apl inline>⎕←</source> or by REPL.
Format in its [[monadic]] form allows the user to convert [[Array model|arrays]] of any [[type]] into simple character arrays (for example for concatenation with other character arrays). The result usually matches the interpreter's default display, either by <syntaxhighlight lang=apl inline>⎕←</source> or by REPL.


<source lang=apl>
<syntaxhighlight lang=apl>
       supper ← 10
       supper ← 10
       'I ate ',(⍕supper),' shrimp.'
       'I ate ',(⍕supper),' shrimp.'
Line 28: Line 28:
[[Dyalog APL]] and [[NARS2000]] support column width and the number of decimal places for formatting [[numeric]] arrays. The following example formats the 2-by-3 array with 12 spaces per column, rounded to 2 decimal places:
[[Dyalog APL]] and [[NARS2000]] support column width and the number of decimal places for formatting [[numeric]] arrays. The following example formats the 2-by-3 array with 12 spaces per column, rounded to 2 decimal places:


<source lang=apl>
<syntaxhighlight lang=apl>
       ⎕←C←2 3⍴ 32.10958 0 ¯101.4914 ¯99.40878 ¯101.872 1001.48173
       ⎕←C←2 3⍴ 32.10958 0 ¯101.4914 ¯99.40878 ¯101.872 1001.48173
  32.10958    0    ¯101.4914  
  32.10958    0    ¯101.4914  
Line 44: Line 44:
[[APLX]] supports '''Format by example''', which uses string left argument for a rich set of format specifications:
[[APLX]] supports '''Format by example''', which uses string left argument for a rich set of format specifications:


<source lang=apl>
<syntaxhighlight lang=apl>
       '55.55' ⍕22.234 1.398 11.00
       '55.55' ⍕22.234 1.398 11.00
22.23 1.4 11
22.23 1.4 11

Revision as of 20:55, 10 September 2022

⍕

Format (⍕) is an ambivalent primitive function which formats the right argument into a simple character array, optionally following the specification supplied as the left argument. The usage of the left argument varies across implementations.

Examples

Monadic form

Format in its monadic form allows the user to convert arrays of any type into simple character arrays (for example for concatenation with other character arrays). The result usually matches the interpreter's default display, either by <syntaxhighlight lang=apl inline>⎕←</source> or by REPL.

<syntaxhighlight lang=apl> 

     supper ← 10
     'I ate ',(⍕supper),' shrimp.'

I ate 10 shrimp. 

     ⎕←DATA←(⍳3) (2 2⍴⍳4) 'TEXT' 100
1 2 3   1 2   TEXT 100
        3 4
     ⍕DATA
1 2 3   1 2   TEXT 100
        3 4
     (⍴DATA) (⍴⍕DATA)
4  2 22

</source>

Dyadic form

The dyadic form of Format varies across implementations.

Dyalog APL and NARS2000 support column width and the number of decimal places for formatting numeric arrays. The following example formats the 2-by-3 array with 12 spaces per column, rounded to 2 decimal places:

<syntaxhighlight lang=apl> 

     ⎕←C←2 3⍴ 32.10958 0 ¯101.4914 ¯99.40878 ¯101.872 1001.48173
32.10958    0     ¯101.4914

¯99.40878 ¯101.872 1001.48173 

     ⍴C

2 3 

     12 2⍕C
      32.11        0.00     ¯101.49
     ¯99.41     ¯101.87     1001.48
     ⍴(12 2⍕C)

2 36

</source>

Works in: Dyalog APL, NARS2000

APLX supports Format by example, which uses string left argument for a rich set of format specifications:

<syntaxhighlight lang=apl> 

     '55.55' ⍕22.234 1.398 11.00

22.23 1.4 11 

     '55.55 5.555 55.55 55'⍕22.234 1.398 0.00 11.0

22.23 1.398 11 

     '555,555,555.55'⍕1234567.89
 1,234,567.89

</source>

Works in: APLX

See also

External links

Tutorials

Documentation


APL built-ins [edit]
Primitives (Timeline) Functions
Scalar
Monadic Conjugate ∙ Negate ∙ Signum ∙ Reciprocal ∙ Magnitude ∙ Exponential ∙ Natural Logarithm ∙ Floor ∙ Ceiling ∙ Factorial ∙ Not ∙ Pi Times ∙ Roll ∙ Type ∙ Imaginary ∙ Square Root ∙ Round
Dyadic Add ∙ Subtract ∙ Times ∙ Divide ∙ Residue ∙ Power ∙ Logarithm ∙ Minimum ∙ Maximum ∙ Binomial ∙ Comparison functions ∙ Boolean functions (And, Or, Nand, Nor) ∙ GCD ∙ LCM ∙ Circular ∙ Complex ∙ Root
Non-Scalar
Structural Shape ∙ Reshape ∙ Tally ∙ Depth ∙ Ravel ∙ Enlist ∙ Table ∙ Catenate ∙ Reverse ∙ Rotate ∙ Transpose ∙ Raze ∙ Mix ∙ Split ∙ Enclose ∙ Nest ∙ Cut (K) ∙ Pair ∙ Link ∙ Partitioned Enclose ∙ Partition
Selection First ∙ Pick ∙ Take ∙ Drop ∙ Unique ∙ Identity ∙ Stop ∙ Select ∙ Replicate ∙ Expand ∙ Set functions (Intersection ∙ Union ∙ Without) ∙ Bracket indexing ∙ Index ∙ Cartesian Product ∙ Sort
Selector Index generator ∙ Grade ∙ Index Of ∙ Interval Index ∙ Indices ∙ Deal ∙ Prefix and suffix vectors
Computational Match ∙ Not Match ∙ Membership ∙ Find ∙ Nub Sieve ∙ Encode ∙ Decode ∙ Matrix Inverse ∙ Matrix Divide ∙ Format ∙ Execute ∙ Materialise ∙ Range
Operators Monadic Each ∙ Commute ∙ Constant ∙ Replicate ∙ Expand ∙ Reduce ∙ Windowed Reduce ∙ Scan ∙ Outer Product ∙ Key ∙ I-Beam ∙ Spawn ∙ Function axis ∙ Identity (Null, Ident)
Dyadic Bind ∙ Compositions (Compose, Reverse Compose, Beside, Withe, Atop, Over) ∙ Inner Product ∙ Determinant ∙ Power ∙ At ∙ Under ∙ Rank ∙ Depth ∙ Variant ∙ Stencil ∙ Cut ∙ Direct definition (operator) ∙ Identity (Lev, Dex)
Quad names Index origin ∙ Comparison tolerance ∙ Migration level ∙ Atomic vector
Retrieved from ‘https://aplwiki.com/index.php?title=Format&oldid=9121’