Formula

From c25389900adcc9915010b1867aa37e691ea05a62 Mon Sep 17 00:00:00 2001 From: Olivier Hallot Date: Wed, 20 Sep 2017 19:08:06 -0300 Subject: tdf#108090 Clarify array separators in help pages Change-Id: I60ddea24020d5775a373b1a06b1bdfa8f33d3c5d Reviewed-on: https://gerrit.libreoffice.org/42571 Reviewed-by: Olivier Hallot Tested-by: Olivier Hallot --- source/text/scalc/01/04060107.xhp | 3 +- source/text/shared/optionen/01060900.xhp | 185 +++++++++++++++++-------------- 2 files changed, 103 insertions(+), 85 deletions(-) diff --git a/source/text/scalc/01/04060107.xhp b/source/text/scalc/01/04060107.xhp index 92ec7c4adc..b9cd4e3e11 100644 --- a/source/text/scalc/01/04060107.xhp +++ b/source/text/scalc/01/04060107.xhp @@ -134,11 +134,12 @@ Ctrl+Enter instead of the Enter key. Only then does the formula become an array formula. Array formulas appear in braces in $[officename] Calc. You cannot create array formulas by manually entering the braces. -The cells in a results array are automatically protected against changes. However, you can edit or copy the array formula by selecting the entire array cell range. +The cells in a results array are automatically protected against changes. However, you can edit or copy the array formula by selecting the entire array cell range. Using Inline Array Constants in Formulas Calc supports inline matrix/array constants in formulas. An inline array is surrounded by curly braces '{' and '}'. Elements can be each a number (including negatives), a logical constant (TRUE, FALSE), or a literal string. Non-constant expressions are not allowed. Arrays can be entered with one or more rows, and one or more columns. All rows must consist of the same number of elements, all columns must consist of the same number of elements. The column separator (separating elements in one row) and the row separator are language and locale dependent. But in this help content, the ';' semicolon and '|' pipe symbol are used to indicate the column and row separators, respectively. For example, in the English locale, the ',' comma is used as the column separator, while the ';' semicolon is used as the row separator. +The row and column separator can be seen and altered in Tools - Options - Calc - Formula - Separators. Arrays can not be nested. Examples: ={1;2;3} diff --git a/source/text/shared/optionen/01060900.xhp b/source/text/shared/optionen/01060900.xhp index 5c6989cbc4..79622c8bd3 100644 --- a/source/text/shared/optionen/01060900.xhp +++ b/source/text/shared/optionen/01060900.xhp @@ -1,6 +1,5 @@ - - - Formula - /text/shared/optionen/01060900.xhp - + + Formula + /text/shared/optionen/01060900.xhp + + -

- - formula options;formula syntax - formula options;separators - formula options;reference syntax in string parameters - formula options;recalculating spreadsheets - formula options;large spreadsheet files - formula options;loading spreadsheet files - separators;function - separators;array column - separators;array row - recalculating;formula options - recalculating;large spreadsheet files - loading;large spreadsheet files - - - Formula - Defines formula syntax options and loading options for %PRODUCTNAME Calc. -

- Formula options - Formula syntax - There are three options. Let's see it by example. In a sample spreadsheet there are two worksheets, Sheet1 and Sheet2. In A1 cell of Sheet1 there is a reference to C4 cell of Sheet2. - - - Calc A1 - This is the default of %PRODUCTNAME Calc. The reference will be =$Sheet2.C4 - - - Excel A1 - This is the default of Microsoft Excel. The reference will be =Sheet2!C4 - - - Excel R1C1 - This is the relative row/column addressing, known from Microsoft Excel. The reference will be =Sheet2!R[3]C[2] - - - Use English function names - In %PRODUCTNAME Calc function names can be localized. By default, the check box is off, which means the localized function names are used. Checking this check box will swap localized function names with the English ones. This change takes effect in all of the following areas: formula input and display, function wizard, and formula tips. You can of course uncheck it to go back to the localized function names. - Separators - This option group lets you configure separators in your formula expressions. This comes in handy when, for instance, you want to separate your function parameters by commas (,) instead of semicolons (;). - For example, instead of =SUM(A1;B1;C1) you can type =SUM(A1,B1,C1). - Likewise, you can also change the column and row separators for in-line arrays. Previously, an in-line array used semicolons (;) as the column separators and the pipe symbols (|) as the row separators, so a typical in-line array expression looked like this for a 5 x 2 matrix array: - ={1;2;3;4;5|6;7;8;9;10} - By changing the column separators to commas (,) and the row separators to semicolons (;), the same expression will look like this: - ={1,2,3,4,5;6,7,8,9,10} - Detailed calculation settings - Here you can configure the formula syntax to use when parsing references given in string parameters. This affects built-in functions such as INDIRECT that takes a reference as a string value. - Recalculation on File Load -Recalculating formulas can take significant time while loading very large files. -Excel 2007 and newer: - -Loading a large spreadsheet file can take a long time. If you don't need to update your large spreadsheet data immediately, you can postpone the recalculation at a better time. -%PRODUCTNAME allows you to defer recalculation of Excel 2007 (and above) spreadsheets to speedup loading time. - -ODF Spreadsheet (not saved by %PRODUCTNAME): - -Recent versions of %PRODUCTNAME caches spreadsheet formula results into its ODF file. -This feature helps %PRODUCTNAME to recalculate a large ODF spreadsheet saved by %PRODUCTNAME faster. - - -For ODF spreadsheets saved by other programs, where such cached formula results may not exist, recalculation can be deferred to speedup file loading as with Excel 2007 files. - -For the entries above the following choices are possible: - - - Never recalculate - No formulas will be recalculated on loading the file. - - - Always recalculate - All formulas will be recalculated on file load. - - - Prompt user - Prompt user for action. - - - - %PRODUCTNAME saved ODF spreadsheets will honor Never recalculate and Always recalculate options. - - - + + +

+ + formula options;formula syntax + formula options;separators + formula options;reference syntax in string parameters + formula options;recalculating spreadsheets + formula options;large spreadsheet files + formula options;loading spreadsheet files + separators;function + separators;array column + separators;array row + recalculating;formula options + recalculating;large spreadsheet files + loading;large spreadsheet files + + + + +Formula +Defines formula syntax options and loading options for %PRODUCTNAME Calc. +

+ +

+ +Formula options + +Formula syntax +There are three options. Let's see it by example. In a sample spreadsheet there are two worksheets, Sheet1 and Sheet2. In A1 cell of Sheet1 there is a reference to C4 cell of Sheet2. + + + + Calc A1 - This is the default of %PRODUCTNAME Calc. The reference will be =$Sheet2.C4 + + + Excel A1 - This is the default of Microsoft Excel. The reference will be =Sheet2!C4 + + + Excel R1C1 - This is the relative row/column addressing, known from Microsoft Excel. The reference will be =Sheet2!R[3]C[2] + + +Use English function names +In %PRODUCTNAME Calc function names can be localized. By default, the check box is off, which means the localized function names are used. Checking this check box will swap localized function names with the English ones. This change takes effect in all of the following areas: formula input and display, function wizard, and formula tips. You can of course uncheck it to go back to the localized function names. + +Separators +This option group lets you configure separators in your formula expressions. This comes in handy when, for instance, you want to separate your function parameters by commas (,) instead of semicolons (;). +For example, instead of =SUM(A1;B1;C1) you can type =SUM(A1,B1,C1). +Likewise, you can also change the column and row separators for in-line arrays. Previously, an in-line array used semicolons (;) as the column separators and the pipe symbols (|) as the row separators, so a typical in-line array expression looked like this for a 5 x 2 matrix array: +={1;2;3;4;5|6;7;8;9;10} +By changing the column separators to commas (,) and the row separators to semicolons (;), the same expression will look like this: +={1,2,3,4,5;6,7,8,9,10} + +Detailed calculation settings +Here you can configure the formula syntax to use when parsing references given in string parameters. This affects built-in functions such as INDIRECT that takes a reference as a string value. + +Recalculation on File Load +Recalculating formulas can take significant time while loading very large files. + +Excel 2007 and newer: +Loading a large spreadsheet file can take a long time. If you don't need to update your large spreadsheet data immediately, you can postpone the recalculation at a better time. %PRODUCTNAME allows you to defer recalculation of Excel 2007 (and above) spreadsheets to speedup loading time. + +ODF Spreadsheet (not saved by %PRODUCTNAME): +Recent versions of %PRODUCTNAME caches spreadsheet formula results into its ODF file. This feature helps %PRODUCTNAME to recalculate a large ODF spreadsheet saved by %PRODUCTNAME faster. +For ODF spreadsheets saved by other programs, where such cached formula results may not exist, recalculation can be deferred to speedup file loading as with Excel 2007 files. +For the entries above the following choices are possible: + + + + Never recalculate - No formulas will be recalculated on loading the file. + + + Always recalculate - All formulas will be recalculated on file load. + + + Prompt user - Prompt user for action. + +%PRODUCTNAME saved ODF spreadsheets will honor Never recalculate and Always recalculate options. + +

+Array formulas +

+ + + \ No newline at end of file -- cgit