[DOC-10857] Add a note to ARRAY_REMOVE()

[rakhi-prathap]

DOC-10857

Added a note to the ARRAY_REMOVE function about removing NULL values.

Preview: https://preview.docs-test.couchbase.com/docs-devex-DOC-10857-update-array-remove/server/current/n1ql/n1ql-language-reference/arrayfun.html#fn-array-remove

Credentials: Preview docs for internal review

[dhanyagowrish]

The description of the DOC ticket (DOC-10857) includes the reason why ARRAY_REMOVE() cannot remove NULL values from an array. Can that be added?

Reasoning from the DOC ticket:

The ARRAY_REMOVE function can't be used to remove NULL values from an array since it uses an equality predicate and NULL doesn't equal NULL.

The internal implementation of the ARRAY_REMOVE() function uses an equality predicate when evaluating the array elements to remove. And since NULL does not equal NULL, the implementation will not remove the NULL values from the array,

[rakhi-prathap]

The description of the DOC ticket (DOC-10857) includes the reason why ARRAY_REMOVE() cannot remove NULL values from an array. Can that be added?

Reasoning from the DOC ticket:

The ARRAY_REMOVE function can't be used to remove NULL values from an array since it uses an equality predicate and NULL doesn't equal NULL.

The internal implementation of the ARRAY_REMOVE() function uses an equality predicate when evaluating the array elements to remove. And since NULL does not equal NULL, the implementation will not remove the NULL values from the array,

Done. Updated the doc to include this information.

[RichardSmedley]

👍