Union: 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 3: Line 3:
== Examples ==
== Examples ==


Both arguments of Intersection is usually restricted to [[vector|vectors]]. Unlike sets in the mathematical sense, duplicate elements are allowed in both sides, and Union is usually implemented as "left argument unchanged, plus the elements of right argument not in the left argument" <source lang=apl inline>X,(~Y∊X)/Y</source>. This preserves the order and multiplicity in both arguments, the left one taking precedence. Both arguments can be [[nested array|nested arrays]].
Both arguments of Intersection is usually restricted to [[vector|vectors]]. Unlike sets in the mathematical sense, duplicate elements are allowed in both sides, and Union is usually implemented as "left argument unchanged, plus the elements of right argument not in the left argument" <source lang=apl inline>X,(~Y∊X)/Y</syntaxhighlight>. This preserves the order and multiplicity in both arguments, the left one taking precedence. Both arguments can be [[nested array|nested arrays]].


<source lang=apl>
<source lang=apl>
Line 14: Line 14:
│THIS│THAT│THE│OTHER│THAN│AND│
│THIS│THAT│THE│OTHER│THAN│AND│
└────┴────┴───┴─────┴────┴───┘
└────┴────┴───┴─────┴────┴───┘
</source>
</syntaxhighlight>


== Extension ==
== Extension ==
Line 27: Line 27:
CC
CC
DD
DD
</source>{{Works in|[[Extended Dyalog APL]]}}
</syntaxhighlight>{{Works in|[[Extended Dyalog APL]]}}
Others can easily define such a function:
Others can easily define such a function:
[https://tio.run/##SyzI0U2pTMzJT///P@JR2wQTBaNHvVvUHR2dnJyBQJ0rEihoDBN0cXF0VOcKzcvMzwMKVz/q3fWod9Wj3q2PevY/6l2h8ahzEVBI0wYsvhkoXsv1qG8qUGWEAliPQuT//wA Try it online!]<source lang=apl>
[https://tio.run/##SyzI0U2pTMzJT///P@JR2wQTBaNHvVvUHR2dnJyBQJ0rEihoDBN0cXF0VOcKzcvMzwMKVz/q3fWod9Wj3q2PevY/6l2h8ahzEVBI0wYsvhkoXsv1qG8qUGWEAliPQuT//wA Try it online!]<source lang=apl>
Line 39: Line 39:
CC
CC
DD
DD
</source>{{Works in|[[Dyalog APL]]}}
</syntaxhighlight>{{Works in|[[Dyalog APL]]}}
== External Links ==
== External Links ==



Revision as of 10:35, 11 September 2022

Union () is a dyadic set function which computes the set union of the two vector arguments.

Examples

Both arguments of Intersection is usually restricted to vectors. Unlike sets in the mathematical sense, duplicate elements are allowed in both sides, and Union is usually implemented as "left argument unchanged, plus the elements of right argument not in the left argument" <source lang=apl inline>X,(~Y∊X)/Y</syntaxhighlight>. This preserves the order and multiplicity in both arguments, the left one taking precedence. Both arguments can be nested arrays.

<source lang=apl>

     'WASH' ∪ 'SHOUT'

WASHOUT

     1 2 3 1 2 3 1 2 3∪5 4 3 2 5 4 3 2

1 2 3 1 2 3 1 2 3 5 4 5 4

     'THIS' 'THAT' 'THE' 'OTHER'∪'OTHER' 'THAN' 'THIS' 'AND' 'THAT'

┌────┬────┬───┬─────┬────┬───┐ │THIS│THAT│THE│OTHER│THAN│AND│ └────┴────┴───┴─────┴────┴───┘ </syntaxhighlight>

Extension

Some dialects allow Union to work on major cells: Try it online!<source lang=apl>

     X←4 2⍴'AABBCCCC'
     Y←3 2⍴'AADDAA'
     X∩Y

AA BB CC CC DD

</syntaxhighlight>

Others can easily define such a function: Try it online!<source lang=apl>

     X←4 2⍴'AABBCCCC'
     Y←3 2⍴'AADDAA'
     Intersection←{⍺⌿⍨(≢⍵)≥⍵⍳⍺}
     X Intersection Y

AA BB CC CC DD

</syntaxhighlight>

Works in: Dyalog APL

External Links

Documentation


APL built-ins [edit]
Primitives (Timeline) Functions
Scalar
Monadic ConjugateNegateSignumReciprocalMagnitudeExponentialNatural LogarithmFloorCeilingFactorialNotPi TimesRollTypeImaginarySquare Root
Dyadic AddSubtractTimesDivideResiduePowerLogarithmMinimumMaximumBinomialComparison functionsBoolean functions (And, Or, Nand, Nor) ∙ GCDLCMCircularComplexRoot
Non-Scalar
Structural ShapeReshapeTallyDepthRavelEnlistTableCatenateReverseRotateTransposeRazeMixSplitEncloseNestCut (K)PairLinkPartitioned EnclosePartition
Selection FirstPickTakeDropUniqueIdentityStopSelectReplicateExpandSet functions (IntersectionUnionWithout) ∙ Bracket indexingIndexCartesian ProductSort
Selector Index generatorGradeIndex OfInterval IndexIndicesDealPrefix and suffix vectors
Computational MatchNot MatchMembershipFindNub SieveEncodeDecodeMatrix InverseMatrix DivideFormatExecuteMaterialiseRange
Operators Monadic EachCommuteConstantReplicateExpandReduceWindowed ReduceScanOuter ProductKeyI-BeamSpawnFunction axis
Dyadic BindCompositions (Compose, Reverse Compose, Beside, Withe, Atop, Over) ∙ Inner ProductDeterminantPowerAtUnderRankDepthVariantStencilCutDirect definition (operator)
Quad names Index originComparison toleranceMigration levelAtomic vector