Skip to content

Commit a6f9476

Browse files
mafanya23mafanya23
authored
Merge pull request #63 from DHTMLX/next
Add dynamic array functions into the related guide
2 parents 5b979a1 + 6b48c40 commit a6f9476

2 files changed

Lines changed: 99 additions & 7 deletions

File tree

‎docs/formulas_locale.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -779,7 +779,7 @@ const en = {
779779
],
780780
"SUMSQ": [
781781
["Number1", "Required. The first argument containing numeric values."],
782-
["Number2", "Optional. The first argument containing numeric values."]
782+
["Number2", "Optional. The second argument containing numeric values."]
783783
],
784784
"SUMX2MY2": [
785785
["Array_x", "Required. The first range or array containing numeric values."],
@@ -1092,13 +1092,13 @@ const en = {
10921092
],
10931093
"TOROW": [
10941094
["Array", "Required. The array to transform."],
1095-
["Ignore", "Required. Control to ignore blanks and errors."],
1096-
["Scan_by_column", "Required. Scan array by column. TRUE = by column, FALSE = by row (default)."]
1095+
["Ignore", "Optional. Control to ignore blanks and errors."],
1096+
["Scan_by_column", "Optional. Scan array by column. TRUE = by column, FALSE = by row (default)."]
10971097
],
10981098
"TOCOL": [
10991099
["Array", "Required. The array to transform."],
1100-
["Ignore", "Required. Setting to ignore blanks and errors."],
1101-
["Scan_by_column", "Required. Scan array by column. TRUE = by column, FALSE = by row (default)."]
1100+
["Ignore", "Optional. Setting to ignore blanks and errors."],
1101+
["Scan_by_column", "Optional. Scan array by column. TRUE = by column, FALSE = by row (default)."]
11021102
],
11031103
"TEXTSPLIT": [
11041104
["Text", "Required. The text string to split."],
@@ -1121,12 +1121,12 @@ const en = {
11211121
"TAKE": [
11221122
["Array", "Required. The source array or range."],
11231123
["Rows", "Optional. Number of rows to return as an integer."],
1124-
["Col", "Optional. Number of columns to return as an integer."]
1124+
["Columns", "Optional. Number of columns to return as an integer."]
11251125
],
11261126
"DROP": [
11271127
["Array", "Required. The source array or range."],
11281128
["Rows", "Optional. Number of rows to drop."],
1129-
["Col", "Optional. Number of columns to drop."]
1129+
["Columns", "Optional. Number of columns to drop."]
11301130
],
11311131
"SEQUENCE": [
11321132
["Rows", "Required. Number of rows to return."],

‎docs/functions.md‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1126,6 +1126,98 @@ Only numbers in the array or reference are multiplied. Empty cells, logical valu
11261126

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

1129+
### Array functions
1130+
1131+
The following array functions were added in v6.0.
1132+
1133+
<table>
1134+
<tbody>
1135+
<tr>
1136+
<td><b>Function</b></td>
1137+
<td><b>Formula</b></td>
1138+
<td><b>Description</b></td>
1139+
</tr>
1140+
<tr>
1141+
<td><b>CHOOSECOLS</b></td>
1142+
<td>=CHOOSECOLS(array, col_num1, [col_num2], ...)</td>
1143+
<td>Returns specified columns from an array or range.</td>
1144+
</tr>
1145+
<tr>
1146+
<td><b>CHOOSEROWS</b></td>
1147+
<td>=CHOOSEROWS(array, row_num1, [row_num2], ...)</td>
1148+
<td>Returns specified rows from an array or range.</td>
1149+
</tr>
1150+
<tr>
1151+
<td><b>DROP</b></td>
1152+
<td>=DROP(array, [rows], [columns])</td>
1153+
<td>Removes a specified number of rows or columns from the start or end of an array.</td>
1154+
</tr>
1155+
<tr>
1156+
<td><b>EXPAND</b></td>
1157+
<td>=EXPAND(array, [rows], [columns], [pad_with])</td>
1158+
<td>Expands or pads an array to specified row and column dimensions.</td>
1159+
</tr>
1160+
<tr>
1161+
<td><b>RANDARRAY</b></td>
1162+
<td>=RANDARRAY([rows], [columns], [min], [max], [integer])</td>
1163+
<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>
1164+
</tr>
1165+
<tr>
1166+
<td><b>SEQUENCE</b></td>
1167+
<td>=SEQUENCE(rows, [columns], [start], [step])</td>
1168+
<td>Generates a list of sequential numbers in an array, such as 1, 2, 3, 4.</td>
1169+
</tr>
1170+
<tr>
1171+
<td><b>SORT</b></td>
1172+
<td>=SORT(array, [sort_index], [sort_order], [by_col])</td>
1173+
<td>Sorts the contents of a range or array. By default, sorts by the first column in ascending order.</td>
1174+
</tr>
1175+
<tr>
1176+
<td><b>SORTBY</b></td>
1177+
<td>=SORTBY(array, by_array, [sort_order], ...)</td>
1178+
<td>Sorts the contents of a range or array based on the values in a corresponding range or array.</td>
1179+
</tr>
1180+
<tr>
1181+
<td><b>TAKE</b></td>
1182+
<td>=TAKE(array, [rows], [columns])</td>
1183+
<td>Returns a specified number of contiguous rows or columns from the start or end of an array.</td>
1184+
</tr>
1185+
<tr>
1186+
<td><b>TEXTSPLIT</b></td>
1187+
<td>=TEXTSPLIT(text, col_delimiter, [row_delimiter], [ignore_empty], [match_mode], [pad_with])</td>
1188+
<td>Splits a text string into rows and columns using the specified delimiters.</td>
1189+
</tr>
1190+
<tr>
1191+
<td><b>TOCOL</b></td>
1192+
<td>=TOCOL(array, [ignore], [scan_by_column])</td>
1193+
<td>Converts an array or range into a single column.</td>
1194+
</tr>
1195+
<tr>
1196+
<td><b>TOROW</b></td>
1197+
<td>=TOROW(array, [ignore], [scan_by_column])</td>
1198+
<td>Converts an array or range into a single row.</td>
1199+
</tr>
1200+
<tr>
1201+
<td><b>UNIQUE</b></td>
1202+
<td>=UNIQUE(array, [by_col], [exactly_once])</td>
1203+
<td>Returns a list of unique values from a range or array.</td>
1204+
</tr>
1205+
<tr>
1206+
<td><b>WRAPCOLS</b></td>
1207+
<td>=WRAPCOLS(vector, wrap_count, [pad_with])</td>
1208+
<td>Wraps a row or column vector into a 2D array by columns after a specified number of values.</td>
1209+
</tr>
1210+
<tr>
1211+
<td><b>WRAPROWS</b></td>
1212+
<td>=WRAPROWS(vector, wrap_count, [pad_with])</td>
1213+
<td>Wraps a row or column vector into a 2D array by rows after a specified number of values.</td>
1214+
</tr>
1215+
</tbody>
1216+
</table>
1217+
<br>
1218+
1219+
Check the example in our [snippet tool](https://snippet.dhtmlx.com/wux2b35b).
1220+
11291221
### Regex functions
11301222

11311223
<table>

0 commit comments

Comments
 (0)