From 8d83686446932bd13406ec6db1153f7395c3907b Mon Sep 17 00:00:00 2001 From: Masha_Rudenko Date: Fri, 22 May 2026 15:19:16 +0300 Subject: [PATCH] [add] dynamic array functions, update formulas locales --- docs/formulas_locale.md | 14 +++---- docs/functions.md | 92 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 99 insertions(+), 7 deletions(-) diff --git a/docs/formulas_locale.md b/docs/formulas_locale.md index a0ad3553..9343203a 100644 --- a/docs/formulas_locale.md +++ b/docs/formulas_locale.md @@ -779,7 +779,7 @@ const en = { ], "SUMSQ": [ ["Number1", "Required. The first argument containing numeric values."], - ["Number2", "Optional. The first argument containing numeric values."] + ["Number2", "Optional. The second argument containing numeric values."] ], "SUMX2MY2": [ ["Array_x", "Required. The first range or array containing numeric values."], @@ -1092,13 +1092,13 @@ const en = { ], "TOROW": [ ["Array", "Required. The array to transform."], - ["Ignore", "Required. Control to ignore blanks and errors."], - ["Scan_by_column", "Required. Scan array by column. TRUE = by column, FALSE = by row (default)."] + ["Ignore", "Optional. Control to ignore blanks and errors."], + ["Scan_by_column", "Optional. Scan array by column. TRUE = by column, FALSE = by row (default)."] ], "TOCOL": [ ["Array", "Required. The array to transform."], - ["Ignore", "Required. Setting to ignore blanks and errors."], - ["Scan_by_column", "Required. Scan array by column. TRUE = by column, FALSE = by row (default)."] + ["Ignore", "Optional. Setting to ignore blanks and errors."], + ["Scan_by_column", "Optional. Scan array by column. TRUE = by column, FALSE = by row (default)."] ], "TEXTSPLIT": [ ["Text", "Required. The text string to split."], @@ -1121,12 +1121,12 @@ const en = { "TAKE": [ ["Array", "Required. The source array or range."], ["Rows", "Optional. Number of rows to return as an integer."], - ["Col", "Optional. Number of columns to return as an integer."] + ["Columns", "Optional. Number of columns to return as an integer."] ], "DROP": [ ["Array", "Required. The source array or range."], ["Rows", "Optional. Number of rows to drop."], - ["Col", "Optional. Number of columns to drop."] + ["Columns", "Optional. Number of columns to drop."] ], "SEQUENCE": [ ["Rows", "Required. Number of rows to return."], diff --git a/docs/functions.md b/docs/functions.md index bb272dce..af45830a 100644 --- a/docs/functions.md +++ b/docs/functions.md @@ -1126,6 +1126,98 @@ Only numbers in the array or reference are multiplied. Empty cells, logical valu Check the example in our [snippet tool](https://snippet.dhtmlx.com/wux2b35b). +### Array functions + +The following array functions were added in v6.0. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FunctionFormulaDescription
CHOOSECOLS=CHOOSECOLS(array, col_num1, [col_num2], ...)Returns specified columns from an array or range.
CHOOSEROWS=CHOOSEROWS(array, row_num1, [row_num2], ...)Returns specified rows from an array or range.
DROP=DROP(array, [rows], [columns])Removes a specified number of rows or columns from the start or end of an array.
EXPAND=EXPAND(array, [rows], [columns], [pad_with])Expands or pads an array to specified row and column dimensions.
RANDARRAY=RANDARRAY([rows], [columns], [min], [max], [integer])Returns an array of random numbers between 0 and 1 by default. You can specify the number of rows and columns to fill, minimum and maximum values, and whether to return whole numbers or decimal values.
SEQUENCE=SEQUENCE(rows, [columns], [start], [step])Generates a list of sequential numbers in an array, such as 1, 2, 3, 4.
SORT=SORT(array, [sort_index], [sort_order], [by_col])Sorts the contents of a range or array. By default, sorts by the first column in ascending order.
SORTBY=SORTBY(array, by_array, [sort_order], ...)Sorts the contents of a range or array based on the values in a corresponding range or array.
TAKE=TAKE(array, [rows], [columns])Returns a specified number of contiguous rows or columns from the start or end of an array.
TEXTSPLIT=TEXTSPLIT(text, col_delimiter, [row_delimiter], [ignore_empty], [match_mode], [pad_with])Splits a text string into rows and columns using the specified delimiters.
TOCOL=TOCOL(array, [ignore], [scan_by_column])Converts an array or range into a single column.
TOROW=TOROW(array, [ignore], [scan_by_column])Converts an array or range into a single row.
UNIQUE=UNIQUE(array, [by_col], [exactly_once])Returns a list of unique values from a range or array.
WRAPCOLS=WRAPCOLS(vector, wrap_count, [pad_with])Wraps a row or column vector into a 2D array by columns after a specified number of values.
WRAPROWS=WRAPROWS(vector, wrap_count, [pad_with])Wraps a row or column vector into a 2D array by rows after a specified number of values.
+
+ +Check the example in our [snippet tool](https://snippet.dhtmlx.com/wux2b35b). + ### Regex functions