4,494
edits
Partitioned Enclose: Difference between revisions
Jump to navigation
Jump to search
m
Partitioned Enclose (view source)
Revision as of 22:18, 10 September 2022
, 22:18, 10 September 2022Text replacement - "</source>" to "</syntaxhighlight>"
mNo edit summary |
m (Text replacement - "</source>" to "</syntaxhighlight>") |
||
| (8 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{Built-in|Partitioned Enclose|⊂}} is a [[dyadic function]] which splits its right argument into differently sized pieces as determined by the | {{Built-in|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: | |||
< | <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]]}} | {{Works in|[[Dyalog APL]], [[Extended Dyalog APL]]}} | ||
== 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: | ||
<syntaxhighlight lang=apl> | |||
2 0 3 0 0 0 0⊂'HiEarth' | 2 0 3 0 0 0 0⊂'HiEarth' | ||
┌┬──┬┬┬─────┐ | ┌┬──┬┬┬─────┐ | ||
││Hi│││Earth│ | ││Hi│││Earth│ | ||
└┴──┴┴┴─────┘ | └┴──┴┴┴─────┘ | ||
</ | </syntaxhighlight> | ||
Additional trailing empty divisions are created by adding an additional division count corresponding to the | == 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]]: | ||
<syntaxhighlight lang=apl> | |||
⍸⍣¯1⊢1 1 3 3 3 | |||
2 0 3 | |||
2 0 3⊂'HiEarth' | |||
┌┬──┬┬┬─────┐ | |||
││Hi│││Earth│ | |||
└┴──┴┴┴─────┘ | |||
</syntaxhighlight> | |||
== 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: | |||
<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 == | |||
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 32: | Line 45: | ||
│How│Are│You?│ | │How│Are│You?│ | ||
└───┴───┴────┘ | └───┴───┴────┘ | ||
</ | </syntaxhighlight> | ||
== See also == | |||
* [[Partition]] | |||
* [[Cut (K)]] | |||
* [[Partition representations]] | |||
==External links== | ==External links== | ||
===Tutorials=== | ===Tutorials=== | ||
| Line 41: | Line 56: | ||
===Documentation=== | ===Documentation=== | ||
* [https://help.dyalog.com/latest/index.htm#Language/Primitive%20Functions/Partitioned%20Enclose.htm Dyalog] | * [https://help.dyalog.com/latest/index.htm#Language/Primitive%20Functions/Partitioned%20Enclose.htm Dyalog] | ||
{{APL built-ins}} | {{APL built-ins}}[[Category:Primitive functions]] | ||