Skip to content

[add] dynamic array functions, update formulas locales #61

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mafanya23 merged 1 commit into from
May 26, 2026
+99 −7
Merged

[add] dynamic array functions, update formulas locales #61

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions docs/formulas_locale.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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."],
Expand Down Expand Up @@ -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."],
Expand All @@ -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."],
Expand Down
92 changes: 92 additions & 0 deletions docs/functions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<table>
<tbody>
<tr>
<td><b>Function</b></td>
<td><b>Formula</b></td>
<td><b>Description</b></td>
</tr>
<tr>
<td><b>CHOOSECOLS</b></td>
<td>=CHOOSECOLS(array, col_num1, [col_num2], ...)</td>
<td>Returns specified columns from an array or range.</td>
</tr>
<tr>
<td><b>CHOOSEROWS</b></td>
<td>=CHOOSEROWS(array, row_num1, [row_num2], ...)</td>
<td>Returns specified rows from an array or range.</td>
</tr>
<tr>
<td><b>DROP</b></td>
<td>=DROP(array, [rows], [columns])</td>
<td>Removes a specified number of rows or columns from the start or end of an array.</td>
</tr>
<tr>
<td><b>EXPAND</b></td>
<td>=EXPAND(array, [rows], [columns], [pad_with])</td>
<td>Expands or pads an array to specified row and column dimensions.</td>
</tr>
<tr>
<td><b>RANDARRAY</b></td>
<td>=RANDARRAY([rows], [columns], [min], [max], [integer])</td>
<td>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.</td>
</tr>
<tr>
<td><b>SEQUENCE</b></td>
<td>=SEQUENCE(rows, [columns], [start], [step])</td>
<td>Generates a list of sequential numbers in an array, such as 1, 2, 3, 4.</td>
</tr>
<tr>
<td><b>SORT</b></td>
<td>=SORT(array, [sort_index], [sort_order], [by_col])</td>
<td>Sorts the contents of a range or array. By default, sorts by the first column in ascending order.</td>
</tr>
<tr>
<td><b>SORTBY</b></td>
<td>=SORTBY(array, by_array, [sort_order], ...)</td>
<td>Sorts the contents of a range or array based on the values in a corresponding range or array.</td>
</tr>
<tr>
<td><b>TAKE</b></td>
<td>=TAKE(array, [rows], [columns])</td>
<td>Returns a specified number of contiguous rows or columns from the start or end of an array.</td>
</tr>
<tr>
<td><b>TEXTSPLIT</b></td>
<td>=TEXTSPLIT(text, col_delimiter, [row_delimiter], [ignore_empty], [match_mode], [pad_with])</td>
<td>Splits a text string into rows and columns using the specified delimiters.</td>
</tr>
<tr>
<td><b>TOCOL</b></td>
<td>=TOCOL(array, [ignore], [scan_by_column])</td>
<td>Converts an array or range into a single column.</td>
</tr>
<tr>
<td><b>TOROW</b></td>
<td>=TOROW(array, [ignore], [scan_by_column])</td>
<td>Converts an array or range into a single row.</td>
</tr>
<tr>
<td><b>UNIQUE</b></td>
<td>=UNIQUE(array, [by_col], [exactly_once])</td>
<td>Returns a list of unique values from a range or array.</td>
</tr>
<tr>
<td><b>WRAPCOLS</b></td>
<td>=WRAPCOLS(vector, wrap_count, [pad_with])</td>
<td>Wraps a row or column vector into a 2D array by columns after a specified number of values.</td>
</tr>
<tr>
<td><b>WRAPROWS</b></td>
<td>=WRAPROWS(vector, wrap_count, [pad_with])</td>
<td>Wraps a row or column vector into a 2D array by rows after a specified number of values.</td>
</tr>
</tbody>
</table>
<br>

Check the example in our [snippet tool](https://snippet.dhtmlx.com/wux2b35b).

### Regex functions

<table>
Expand Down