Package dev.frostlake.functions.scalar.semistructured

Class ArrayConstructCompact

java.lang.Object
dev.frostlake.functions.BuiltInFunction
dev.frostlake.functions.scalar.semistructured.ArrayConstructCompact
public class ArrayConstructCompact extends BuiltInFunction
ARRAY_CONSTRUCT_COMPACT(val1, val2, …) — builds a JSON array from the given values, OMITTING every SQL NULL (so the result can be shorter than the argument list). A VARIANT JSON null is a value, not a SQL NULL, and is therefore kept — matching Snowflake.

The surviving values are converted by ArrayConstruct, so both functions render identically.

  • Constructor Details

    • ArrayConstructCompact

      public ArrayConstructCompact()

  • Method Details

    • structuredRejection

      public SemiStructuredRejection structuredRejection(int position)
      The same structured refusal ArrayConstruct declares, measured for this name too: live ARRAY_CONSTRUCT_COMPACT(o) builds its array while ARRAY_CONSTRUCT_COMPACT(so) is "Function ARRAY_CONSTRUCT_COMPACT does not support OBJECT(x VARCHAR(16777216)) argument type". It is declared again rather than inherited because this class delegates to an ArrayConstruct INSTANCE instead of extending it.
      Overrides:
      structuredRejection in class BuiltInFunction
      Parameters:
      position - the zero-based argument position being asked about
      Returns:
      the extra refusal this position gives a structured value, or NONE when undeclared

    • evaluate

      public Object evaluate(List<Object> args)
      Description copied from class: BuiltInFunction
      Computes the function's result over its already-evaluated argument values. A SQL NULL argument arrives as Java null, and returning null makes the SQL result NULL.
      Specified by:
      evaluate in class BuiltInFunction
      Parameters:
      args - the argument values, in call order
      Returns:
      the function's value for these arguments, or null for SQL NULL

    • getMinArgCount

      public int getMinArgCount()
      Description copied from class: BuiltInFunction
      The fewest arguments a call to this function may pass; fewer is an argument-count error.
      Specified by:
      getMinArgCount in class BuiltInFunction
      Returns:
      the minimum accepted argument count

    • getMaxArgCount

      public int getMaxArgCount()
      Description copied from class: BuiltInFunction
      The most arguments a call to this function may pass; Integer.MAX_VALUE marks a variadic function (see BuiltInFunction.isVariadic()).
      Specified by:
      getMaxArgCount in class BuiltInFunction
      Returns:
      the maximum accepted argument count