From 9201f2351fa94a6f26375ab084f1e0c882db6001 Mon Sep 17 00:00:00 2001 From: Steve Fanning Date: Tue, 31 Mar 2020 18:26:11 -0300 Subject: tdf#131360 Adjust number of function param (2) Fix for GETPIVOTDATA, IMPRODUCT, IMSUM Change-Id: I4c8e7600d53a2010b85d1387f7f368a5b6cee79a Reviewed-on: https://gerrit.libreoffice.org/c/help/+/91456 Tested-by: Jenkins Reviewed-by: Olivier Hallot --- source/text/scalc/01/04060109.xhp | 83 +++++++++++++++++----------------- source/text/scalc/01/04060116.xhp | 94 ++++++++++++++++++++------------------- 2 files changed, 89 insertions(+), 88 deletions(-) (limited to 'source') diff --git a/source/text/scalc/01/04060109.xhp b/source/text/scalc/01/04060109.xhp index 576dff2ea2..74acea5301 100644 --- a/source/text/scalc/01/04060109.xhp +++ b/source/text/scalc/01/04060109.xhp @@ -31,7 +31,7 @@ Function Wizard; spreadsheets functions; spreadsheets -Spreadsheet Functions +

Spreadsheet Functions

This section contains descriptions of the Spreadsheet functions together with an example.
@@ -41,7 +41,7 @@ ADDRESS function -ADDRESS +

ADDRESS

Returns a cell address (reference) as text, according to the specified row and column numbers. You can determine whether the address is interpreted as an absolute address (for example, $A$1) or as a relative address (as A1) or in a mixed form (A$1 or $A1). You can also specify the name of the sheet.
For interoperability the ADDRESS and INDIRECT functions support an optional parameter to specify whether the R1C1 address notation instead of the usual A1 notation should be used. @@ -51,8 +51,8 @@ In case of R1C1 notation, ADDRESS returns address strings using the exclamation mark '!' as the sheet name separator, and INDIRECT expects the exclamation mark as sheet name separator. Both functions still use the dot '.' sheet name separator with A1 notation. When opening documents from ODF 1.0/1.1 format, the ADDRESS functions that show a sheet name as the fourth parameter will shift that sheet name to become the fifth parameter. A new fourth parameter with the value 1 will be inserted. When storing a document in ODF 1.0/1.1 format, if ADDRESS functions have a fourth parameter, that parameter will be removed. - Do not save a spreadsheet in the old ODF 1.0/1.1 format if the ADDRESS function's new fourth parameter was used with a value of 0. - The INDIRECT function is saved without conversion to ODF 1.0/1.1 format. If the second parameter was present, an older version of Calc will return an error for that function. + Do not save a spreadsheet in the old ODF 1.0/1.1 format if the ADDRESS function's new fourth parameter was used with a value of 0. + The INDIRECT function is saved without conversion to ODF 1.0/1.1 format. If the second parameter was present, an older version of Calc will return an error for that function.
ADDRESS(Row; Column; Abs; A1; "Sheet") @@ -70,7 +70,7 @@ A1 (optional) - if set to 0, the R1C1 notation is used. If this parameter is absent or set to another value than 0, the A1 notation is used. Sheet represents the name of the sheet. It must be placed in double quotes. - Example: +

Example:

=ADDRESS(1;1;2;;"Sheet2") returns the following: Sheet2.A$1i 101187 If the formula above is in cell B2 of current sheet, and the cell A1 in sheet 2 contains the value -6, you can refer indirectly to the referenced cell using a function in B2 by entering =ABS(INDIRECT(B2)). The result is the absolute value of the cell reference specified in B2, which in this case is 6. @@ -79,7 +79,7 @@ AREAS function -AREAS +

AREAS

Returns the number of individual ranges that belong to a multiple range. A range can consist of contiguous cells or a single cell. The function expects a single argument. If you state multiple ranges, you must enclose them into additional parentheses. Multiple ranges can be entered using the semicolon (;) as divider, but this gets automatically converted to the tilde (~) operator. The tilde is used to join ranges. @@ -95,7 +95,7 @@ DDE function -DDE +

DDE

Returns the result of a DDE-based link. If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose Edit - Links to see the updated links. Cross-platform links, for example from a %PRODUCTNAME installation running on a Windows machine to a document created on a Linux machine, are not allowed. DDE("Server"; "File"; "Range"; Mode) @@ -156,10 +156,10 @@ ERRORTYPE function -ERRORTYPE +

ERRORTYPE

Returns the number corresponding to an error value occurring in a different cell. With the aid of this number, you can generate an error message text. - The Status Bar displays the predefined error code from %PRODUCTNAME if you click the cell containing the error. + The Status Bar displays the predefined error code from %PRODUCTNAME if you click the cell containing the error. ERRORTYPE(Reference) @@ -168,14 +168,14 @@ If cell A1 displays Err:518, the function =ERRORTYPE(A1) returns the number 518.
- +

INDEX function -INDEX +

INDEX

INDEX returns a sub range, specified by row and column number, or an optional range index. Depending on context, INDEX returns a reference or content.UFI: will change with i4904; see http://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i57108changed by i83070 INDEX(Reference; Row; Column; Range) @@ -207,7 +207,7 @@ INDIRECT function -INDIRECT +

INDIRECT

Returns the reference specified by a text string. This function can also be used to return the area of a corresponding string. @@ -216,7 +216,7 @@ Ref represents a reference to a cell or an area (in text form) for which to return the contents. A1 (optional) - if set to 0, the R1C1 notation is used. If this parameter is absent or set to another value than 0, the A1 notation is used. - If you open an Excel spreadsheet that uses indirect addresses calculated from string functions, the sheet addresses will not be translated automatically. For example, the Excel address in INDIRECT("[filename]sheetname!"&B1) is not converted into the Calc address in INDIRECT("filename#sheetname."&B1).UFI: for #i34465# + If you open an Excel spreadsheet that uses indirect addresses calculated from string functions, the sheet addresses will not be translated automatically. For example, the Excel address in INDIRECT("[filename]sheetname!"&B1) is not converted into the Calc address in INDIRECT("filename#sheetname."&B1).UFI: for #i34465# =INDIRECT(A1) equals 100 if A1 contains C108 as a reference and cell C108 contains a value of 100. @@ -227,7 +227,7 @@ COLUMN function -COLUMN +

COLUMN

Returns the column number of a cell reference. If the reference is a cell the column number of the cell is returned; if the parameter is a cell area, the corresponding column numbers are returned in a single-row array if the formula is entered as an array formula. If the COLUMN function with an area reference parameter is not used for an array formula, only the column number of the first cell within the area is determined. COLUMN(Reference) @@ -252,7 +252,7 @@ COLUMNS function -COLUMNS +

COLUMNS

Returns the number of columns in the given reference. COLUMNS(Array) @@ -271,7 +271,7 @@ VLOOKUP function -VLOOKUP +

VLOOKUP

Vertical search with reference to adjacent cells to the right. This function checks if a specific value is contained in the first column of an array. The function then returns the value in the same row of the column named by Index. If the Sorted parameter is omitted or set to TRUE or one, it is assumed that the data is sorted in ascending order. In this case, if the exact SearchCriterion is not found, the last value that is smaller than the criterion will be returned. If Sorted is set to FALSE or zero, an exact match must be found, otherwise the error Error: Value Not Available will be the result. Thus with a value of zero the data does not need to be sorted in ascending order. @@ -298,7 +298,7 @@ SHEET function -SHEET +

SHEET

Returns the sheet number of a reference or a string representing a sheet name. If you do not enter any parameters, the result is the sheet number of the spreadsheet containing the formula. SHEET(Reference) @@ -313,7 +313,7 @@ SHEETS function -SHEETS +

SHEETS

Determines the number of sheets in a reference. If you do not enter any parameters, it returns the number of sheets in the current document. SHEETS(Reference) @@ -327,7 +327,7 @@ MATCH function -MATCH +

MATCH

Returns the relative position of an item in an array that matches a specified value. The function returns the position of the value found in the lookup_array as a number. MATCH(SearchCriterion; LookupArray; Type) @@ -348,7 +348,7 @@ OFFSET function -OFFSET +

OFFSET

Returns the value of a cell offset by a certain number of rows and columns from a given reference point. OFFSET(Reference; Rows; Columns; Height; Width) @@ -380,15 +380,15 @@ =OFFSET(B2:C3;1;0;3;4) returns a reference to B2:C3 moved down by one row resized to 3 rows and 4 columns (B3:E5). =SUM(OFFSET(A1;2;2;5;6)) determines the total of the area that starts in cell C3 and has a height of 5 rows and a width of 6 columns (area=C3:H7). - If the width or height is included, the OFFSET function returns a range and thus must be entered as an array formula. If both the width and height are missing, a cell reference is returned. + If the width or height is included, the OFFSET function returns a range and thus must be entered as an array formula. If both the width and height are missing, a cell reference is returned.
LOOKUP function -LOOKUP +

LOOKUP

Returns the contents of a cell either from a one-row or one-column range. Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to VLOOKUP and HLOOKUP, search and result vector may be at different positions; they do not have to be adjacent. Additionally, the search vector for the LOOKUP must be sorted ascending, otherwise the search will not return any usable results. - If LOOKUP cannot find the search criterion, it matches the largest value in the search vector that is less than or equal to the search criterion. + If LOOKUP cannot find the search criterion, it matches the largest value in the search vector that is less than or equal to the search criterion. LOOKUP(SearchCriterion; SearchVector; ResultVector) @@ -407,7 +407,7 @@ STYLE function -STYLE +

STYLE

Applies a style to the cell containing the formula. After a set amount of time, another style can be applied. This function always returns the value 0, allowing you to add it to another function without changing the value. Together with the CURRENT function you can apply a color to a cell depending on the value. For example: =...+STYLE(IF(CURRENT()>3;"red";"green")) applies the style "red" to the cell if the value is greater than 3, otherwise the style "green" is applied. Both cell formats, "red" and "green" have to be defined beforehand. STYLE("Style"; Time; "Style2") @@ -433,7 +433,7 @@ CHOOSE function -CHOOSE +

CHOOSE

Uses an index to return a value from a list of up to 30 values. CHOOSE(Index; Value1; ...; Value30) @@ -449,7 +449,7 @@ HLOOKUP function -HLOOKUP +

HLOOKUP

Searches for a value and reference to the cells below the selected area. This function verifies if the first row of an array contains a certain value. The function returns then the value in a row of the array, named in the Index, in the same column. @@ -461,7 +461,7 @@ ROW function -ROW +

ROW

Returns the row number of a cell reference. If the reference is a cell, it returns the row number of the cell. If the reference is a cell range, it returns the corresponding row numbers in a one-column Array if the formula is entered as an array formula. If the ROW function with a range reference is not used in an array formula, only the row number of the first range cell will be returned. ROW(Reference) @@ -486,7 +486,7 @@ ROWS function -ROWS +

ROWS

Returns the number of rows in a reference or array. ROWS(Array) @@ -504,10 +504,10 @@ HYPERLINK function -HYPERLINK +

HYPERLINK

When you click a cell that contains the HYPERLINK function, the hyperlink opens. If you use the optional CellText parameter, the formula locates the URL, and then displays the text or number. - To open a hyperlinked cell with the keyboard, select the cell, press F2 to enter the Edit mode, move the cursor in front of the hyperlink, press Shift+F10, and then choose Open Hyperlink. + To open a hyperlinked cell with the keyboard, select the cell, press F2 to enter the Edit mode, move the cursor in front of the hyperlink, press Shift+F10, and then choose Open Hyperlink. HYPERLINK("URL") or HYPERLINK("URL"; "CellText") @@ -533,14 +533,15 @@ GETPIVOTDATA function -GETPIVOTDATA +

GETPIVOTDATA

The GETPIVOTDATA function returns a result value from a pivot table. The value is addressed using field and item names, so it remains valid if the layout of the pivot table changes. Two different syntax definitions can be used: - GETPIVOTDATA(TargetField; pivot table; [ Field 1; Item 1; ... ]) - GETPIVOTDATA(pivot table; Constraints) + GETPIVOTDATA(TargetField; pivot table[; Field 1; Item 1][; ... [Field 126; Item 126]]) + or + GETPIVOTDATA(pivot table; Constraints) The second syntax is assumed if exactly two parameters are given, of which the first parameter is a cell or cell range reference. The first syntax is assumed in all other cases. The Function Wizard shows the first syntax. - +

First Syntax

TargetField is a string that selects one of the pivot table's data fields. The string can be the name of the source column, or the data field name as shown in the table (like "Sum - Sales"). @@ -550,18 +551,16 @@ If the source data contains entries that are hidden by settings of the pivot table, they are ignored. The order of the Field/Item pairs is not significant. Field and item names are not case-sensitive. If no constraint for a page field is given, the field's selected value is implicitly used. If a constraint for a page field is given, it must match the field's selected value, or an error is returned. Page fields are the fields at the top left of a pivot table, populated using the "Page Fields" area of the pivot table layout dialog. From each page field, an item (value) can be selected, which means only that item is included in the calculation. Subtotal values from the pivot table are only used if they use the function "auto" (except when specified in the constraint, see Second Syntax below). - - - pivot table has the same meaning as in the first syntax. - - Constraints is a space-separated list. Entries can be quoted (single quotes). The whole string must be enclosed in quotes (double quotes), unless you reference the string from another cell. +

Second Syntax

+ pivot table has the same meaning as in the first syntax. + Constraints is a space-separated list. Entries can be quoted (single quotes). The whole string must be enclosed in quotes (double quotes), unless you reference the string from another cell. One of the entries can be the data field name. The data field name can be left out if the pivot table contains only one data field, otherwise it must be present. Each of the other entries specifies a constraint in the form Field[Item] (with literal characters [ and ]), or only Item if the item name is unique within all fields that are used in the pivot table.i82342 A function name can be added in the form Field[Item;Function], which will cause the constraint to match only subtotal values which use that function. The possible function names are Sum, Count, Average, Max, Min, Product, Count (Numbers only), StDev (Sample), StDevP (Population), Var (Sample), and VarP (Population), case-insensitive.UFI: Example from spec doc is quite difficult to localize. Try to find other one
- -
- + + + diff --git a/source/text/scalc/01/04060116.xhp b/source/text/scalc/01/04060116.xhp index 5773dbe3b8..8756835f9e 100644 --- a/source/text/scalc/01/04060116.xhp +++ b/source/text/scalc/01/04060116.xhp @@ -30,7 +30,7 @@ imaginary numbers in analysis functions complex numbers in analysis functions -Add-in Functions, List of Analysis Functions Part Two +

Add-in Functions, List of Analysis Functions Part Two

@@ -40,7 +40,7 @@ IMABS function -IMABS +

IMABS

The result is the absolute value of a complex number. IMABS("ComplexNumber") @@ -54,7 +54,7 @@ IMAGINARY function -IMAGINARY +

IMAGINARY

The result is the imaginary coefficient of a complex number. IMAGINARY("ComplexNumber") @@ -67,7 +67,7 @@ IMPOWER function -IMPOWER +

IMPOWER

The result is the ComplexNumber raised to the power of Number. IMPOWER("ComplexNumber"; Number) @@ -82,7 +82,7 @@ IMARGUMENT function -IMARGUMENT +

IMARGUMENT

The result is the argument (the phi angle) of a complex number. IMARGUMENT("ComplexNumber") @@ -92,41 +92,41 @@ =IMARGUMENT("3+4j") returns 0.927295.
- +

- +

- +

- +

- +

- +

- +

- +

- +

- +

@@ -135,7 +135,7 @@ IMDIV function -IMDIV +

IMDIV

The result is the division of two complex numbers. IMDIV("Numerator"; "Denominator") @@ -149,7 +149,7 @@ IMEXP function -IMEXP +

IMEXP

The result is the power of e and the complex number. The constant e has a value of approximately 2.71828182845904. IMEXP("ComplexNumber") @@ -162,7 +162,7 @@ IMCONJUGATE function -IMCONJUGATE +

IMCONJUGATE

The result is the conjugated complex complement to a complex number. IMCONJUGATE("ComplexNumber") @@ -175,7 +175,7 @@ IMLN function -IMLN +

IMLN

The result is the natural logarithm (to the base e) of a complex number. The constant e has a value of approximately 2.71828182845904. IMLN("ComplexNumber") @@ -188,7 +188,7 @@ IMLOG10 function -IMLOG10 +

IMLOG10

The result is the common logarithm (to the base 10) of a complex number. IMLOG10("ComplexNumber") @@ -201,7 +201,7 @@ IMLOG2 function -IMLOG2 +

IMLOG2

The result is the binary logarithm of a complex number. IMLOG2("ComplexNumber") @@ -214,10 +214,11 @@ IMPRODUCT function -IMPRODUCT - The result is the product of up to 29 complex numbers. +

IMPRODUCT

+ The result is the product of a set of complex numbers. - IMPRODUCT("ComplexNumber"; "ComplexNumber1"; ...) + IMPRODUCT() + @@ -227,7 +228,7 @@ IMREAL function -IMREAL +

IMREAL

The result is the real coefficient of a complex number. IMREAL("ComplexNumber") @@ -237,41 +238,41 @@ =IMREAL("1+3j") returns 1.
- +

- +

- +

- +

- +

- +

- +

- +

- +

- +

@@ -280,7 +281,7 @@ IMSUB function -IMSUB +

IMSUB

The result is the subtraction of two complex numbers. IMSUB("ComplexNumber1"; "ComplexNumber2") @@ -293,10 +294,11 @@ IMSUM function -IMSUM - The result is the sum of up to 29 complex numbers. +

IMSUM

+ The result is the sum of a set of complex numbers. - IMSUM("ComplexNumber1"; "ComplexNumber2"; ...) + IMSUM() + @@ -306,7 +308,7 @@ IMSQRT function -IMSQRT +

IMSQRT

The result is the square root of a complex number. IMSQRT("ComplexNumber") @@ -319,7 +321,7 @@ COMPLEX function -COMPLEX +

COMPLEX

The result is a complex number which is returned from a real coefficient and an imaginary coefficient. COMPLEX(RealNum; INum; Suffix) @@ -338,7 +340,7 @@ converting;octal numbers, into binary numbers mw added one entry -OCT2BIN +

OCT2BIN

The result is the binary number for the octal number entered. OCT2BIN(Number; Places) @@ -355,7 +357,7 @@ converting;octal numbers, into decimal numbers mw added one entry -OCT2DEC +

OCT2DEC

The result is the decimal number for the octal number entered. OCT2DEC(Number) @@ -370,7 +372,7 @@ converting;octal numbers, into hexadecimal numbers mw added one entry -OCT2HEX +

OCT2HEX

The result is the hexadecimal number for the octal number entered. OCT2HEX(Number; Places) @@ -386,7 +388,7 @@ CONVERT function -CONVERT +

CONVERT

Converts a value from one unit of measure to the corresponding value in another unit of measure. Enter the units of measures directly as text in quotation marks or as a reference. If you enter the units of measure in cells, they must correspond exactly with the following list which is case sensitive: For example, in order to enter a lower case l (for liter) in a cell, enter the apostrophe ' immediately followed by l. @@ -709,7 +711,7 @@ factorials;numbers with increments of two mw added one entry -FACTDOUBLE +

FACTDOUBLE

Returns the double factorial of a number. FACTDOUBLE(Number) -- cgit