Skip to content

doc: Explain NULLs handling for array_* builtin functions  #21014

Closed

Description

@comphead

This reminds me of our earlier discussion about arrays with NULL in them. Should we document at a high level somewhere what semantics we're adopting arrays with NULL in them?

Originally posted by @mbutrovich in #21013 (review)

The idea to add NULL handling behavior to description, for example:

#[user_doc(
    doc_section(label = "Array Functions"),
    description = "Removes the first `max` elements from the array equal to the given value. <ADD HERE expectation when dealing with NULLs>",
    syntax_example = "array_remove_n(array, element, max))",

Activity

  1. Xavrir commented on Mar 18, 2026

    @Xavrir
    Contributor

    Hello!, I want to help with this issue

  2. Xavrir commented on Mar 18, 2026

    @Xavrir
    Contributor

    Opened #21018 to clarify the documented NULL behavior for , , and , and to add regression coverage for scalar and row-wise NULL inputs.

  3. Xavrir commented on Mar 18, 2026

    @Xavrir
    Contributor

    Correction: opened #21018 to clarify the documented NULL behavior for array_remove, array_remove_n, and array_remove_all, and to add regression coverage for scalar and row-wise NULL inputs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationgood first issueGood for newcomers

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions