Partitioned Enclose: Difference between revisions
No edit summary |
m (Text replacement - "</source>" to "</syntaxhighlight>") |
||
(One intermediate revision by the same user not shown) | |||
Line 2: | Line 2: | ||
== Basic functionality == | == Basic functionality == | ||
In the simplest case, and on a vector right argument, the corresponding element in the left argument indicates where '''divisions''' begin: | In the simplest case, and on a vector right argument, the corresponding element in the left argument indicates where '''divisions''' begin: | ||
< | <syntaxhighlight lang=apl> | ||
1 0 1 0 0 0 0⊂'HiEarth' | 1 0 1 0 0 0 0⊂'HiEarth' | ||
┌──┬─────┐ | ┌──┬─────┐ | ||
│Hi│Earth│ | │Hi│Earth│ | ||
└──┴─────┘ | └──┴─────┘ | ||
</ | </syntaxhighlight> | ||
{{Works in|[[Dyalog APL]], [[Extended Dyalog APL]]}} | {{Works in|[[Dyalog APL]], [[Extended Dyalog APL]]}} | ||
== Non-Boolean left argument == | == Non-Boolean left argument == | ||
Almost all dialects restrict the left argument to provide only the above functionality. However, the left argument can be interpreted as a count of how many partitions begin with a particular position: | Almost all dialects restrict the left argument to provide only the above functionality. However, the left argument can be interpreted as a count of how many partitions begin with a particular position: | ||
< | <syntaxhighlight lang=apl> | ||
2 0 3 0 0 0 0⊂'HiEarth' | 2 0 3 0 0 0 0⊂'HiEarth' | ||
┌┬──┬┬┬─────┐ | ┌┬──┬┬┬─────┐ | ||
││Hi│││Earth│ | ││Hi│││Earth│ | ||
└┴──┴┴┴─────┘ | └┴──┴┴┴─────┘ | ||
</ | </syntaxhighlight> | ||
== Short left argument == | == Short left argument == | ||
The dialects that support this extension also allow omission of trailing zeros, which is useful if the partitioning vector is generated by [[indices#Inverse|where's inverse]]: | The dialects that support this extension also allow omission of trailing zeros, which is useful if the partitioning vector is generated by [[indices#Inverse|where's inverse]]: | ||
< | <syntaxhighlight lang=apl> | ||
⍸⍣¯1⊢1 1 3 3 3 | ⍸⍣¯1⊢1 1 3 3 3 | ||
2 0 3 | 2 0 3 | ||
Line 26: | Line 26: | ||
││Hi│││Earth│ | ││Hi│││Earth│ | ||
└┴──┴┴┴─────┘ | └┴──┴┴┴─────┘ | ||
</ | </syntaxhighlight> | ||
== Long left argument == | == Long left argument == | ||
Additional trailing empty divisions are created by adding an additional division count corresponding to the position beyond the end of the right argument: | Additional trailing empty divisions are created by adding an additional division count corresponding to the position beyond the end of the right argument: | ||
< | <syntaxhighlight lang=apl> | ||
1 0 1 0 0 0 0 1⊂'HiEarth' | 1 0 1 0 0 0 0 1⊂'HiEarth' | ||
┌──┬─────┬┐ | ┌──┬─────┬┐ | ||
│Hi│Earth││ | │Hi│Earth││ | ||
└──┴─────┴┘ | └──┴─────┴┘ | ||
</ | </syntaxhighlight> | ||
== Split into lengths == | == Split into lengths == | ||
This above extensions allow a simple definition of a split-into-lengths function: | This above extensions allow a simple definition of a split-into-lengths function: | ||
[https://tio.run/##SyzI0U2pTMzJT9dNrShJzUtJTfn/qLdP/VHf1GBXvZRHbROqNQxtH3UufNS7S/NRx/JHvWvAnC1AvhVQEVABkJWSVqJg8Ki7BSKQkllcABSshQgAjdEAUuHB6uquZal5JerqGurqwanFxZn5eQFFmSABBXX1FHV1zUddi4EKnSOBvLS8YqCA@v/ggpzMEpAjHvVuVXjU1fSod4XCo94dj3oXH1pvqKAdowCkHrVNNtQB2ff/v7GCsYKJAliTgrpHfrljUWpkfqm9OgA Try it online!] | [https://tio.run/##SyzI0U2pTMzJT9dNrShJzUtJTfn/qLdP/VHf1GBXvZRHbROqNQxtH3UufNS7S/NRx/JHvWvAnC1AvhVQEVABkJWSVqJg8Ki7BSKQkllcABSshQgAjdEAUuHB6uquZal5JerqGurqwanFxZn5eQFFmSABBXX1FHV1zUddi4EKnSOBvLS8YqCA@v/ggpzMEpAjHvVuVXjU1fSod4XCo94dj3oXH1pvqKAdowCkHrVNNtQB2ff/v7GCsYKJAliTgrpHfrljUWpkfqm9OgA Try it online!] | ||
< | <syntaxhighlight lang=apl> | ||
Split←{⍵ ⊂⍨ ⍸⍣¯1 +\ ¯1↓1,⍺} | Split←{⍵ ⊂⍨ ⍸⍣¯1 +\ ¯1↓1,⍺} | ||
3 3 4 Split 'HowAreYou?' | 3 3 4 Split 'HowAreYou?' | ||
Line 45: | Line 45: | ||
│How│Are│You?│ | │How│Are│You?│ | ||
└───┴───┴────┘ | └───┴───┴────┘ | ||
</ | </syntaxhighlight> | ||
== See also == | == See also == | ||
* [[Partition]] | * [[Partition]] |
Revision as of 22:18, 10 September 2022
⊂
|
Partitioned Enclose (⊂
) is a dyadic function which splits its right argument into differently sized pieces as determined by the left argument.
Basic functionality
In the simplest case, and on a vector right argument, the corresponding element in the left argument indicates where divisions begin:
1 0 1 0 0 0 0⊂'HiEarth' ┌──┬─────┐ │Hi│Earth│ └──┴─────┘
Non-Boolean left argument
Almost all dialects restrict the left argument to provide only the above functionality. However, the left argument can be interpreted as a count of how many partitions begin with a particular position:
2 0 3 0 0 0 0⊂'HiEarth' ┌┬──┬┬┬─────┐ ││Hi│││Earth│ └┴──┴┴┴─────┘
Short left argument
The dialects that support this extension also allow omission of trailing zeros, which is useful if the partitioning vector is generated by where's inverse:
⍸⍣¯1⊢1 1 3 3 3 2 0 3 2 0 3⊂'HiEarth' ┌┬──┬┬┬─────┐ ││Hi│││Earth│ └┴──┴┴┴─────┘
Long left argument
Additional trailing empty divisions are created by adding an additional division count corresponding to the position beyond the end of the right argument:
1 0 1 0 0 0 0 1⊂'HiEarth' ┌──┬─────┬┐ │Hi│Earth││ └──┴─────┴┘
Split into lengths
This above extensions allow a simple definition of a split-into-lengths function:
Split←{⍵ ⊂⍨ ⍸⍣¯1 +\ ¯1↓1,⍺} 3 3 4 Split 'HowAreYou?' ┌───┬───┬────┐ │How│Are│You?│ └───┴───┴────┘