Add arraySymmetricDifference function

[pheepa]

Exported logic from arrayIntersect to arrayLogicalFunction class that covers handling both intersection and symmetric difference. Added arraySymmetricDifference function with docs and tests.

Changelog category (leave one):

• New Feature

Changelog entry (a user-readable short description of the changes that goes to CHANGELOG.md):

Added function arraySymmetricDifference. This closes: #61673

Documentation entry for user-facing changes

• Documentation is written

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
2 out of 3 committers have signed the CLA.

✅ pheepa
✅ rschu1ze
❌ f.abapolov

---

f.abapolov seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[pheepa]

Can someone approve my CLA sign?...
Some commits were made from work pc without linked email in git config. Here said that old commits can't be linked to email, only new ones.

[robot-ch-test-poll]

This is an automated comment for commit cdc42b5 with description of existing statuses. It's updated for the latest CI running

❌ Click here to open a full report in a separate page

Check name	Description	Status
A Sync	There's no description for the check yet, please add it to tests/ci/ci_config.py:CHECK_DESCRIPTIONS	⏳ pending
CI running	A meta-check that indicates the running CI. Normally, it's in success or pending state. The failed status indicates some problems with the PR	⏳ pending
ClickHouse build check	Builds ClickHouse in various configurations for use in further steps. You have to fix the builds that fail. Build logs often has enough information to fix the error, but you might have to reproduce the failure locally. The cmake options can be found in the build log, grepping for cmake. Use these options and follow the general build process	⏳ pending
Fast test	Normally this is the first check that is ran for a PR. It builds ClickHouse and runs most of stateless functional tests, omitting some. If it fails, further checks are not started until it is fixed. Look at the report to see which tests fail, then reproduce the failure locally as described here	❌ failure
Mergeable Check	Checks if all other necessary checks are successful	❌ failure

Successful checks

Check name	Description	Status
PR Check	There's no description for the check yet, please add it to tests/ci/ci_config.py:CHECK_DESCRIPTIONS	✅ success
Style check	Runs a set of checks to keep the code style clean. If some of tests failed, see the related log from the report	✅ success

[nikitamikhaylov]

The extracted part should be also useful for #61553

[rschu1ze]

Comment related to this file in general. Please add in strategic places high-level comments what the code/algorithms is doing. For a casual reader, it is almost impossible to follow without tedious debugging to understand what is happening in this file.

(as an example, you could look at src/Functions/array/arrayFold.cpp which I commented recently after a severe bug was found in the initial implementation)

[rschu1ze]

Can someone approve my CLA sign?...
Some commits were made from work pc without linked email in git config. Here said that old commits can't be linked to email, only new ones.

@pheepa GitHub won't let me do that, but unfortunately we need to have the CLA signed. Also, the commit history of this PR is really messy. What about if you squash all your and my commits into a new commit - make sure that Git uses your verified mail address - and force-push (which is generally bad practice but okay in this case)?

[rschu1ze]

The test failures are related, could you please check them?

[pheepa]

Also, the commit history of this PR is really messy.

I completely agree, lets drop this one, I will reopen new with fixes and add your commits

The test failures are related, could you please check them?

I am trying to fix them