\<bookmark_value\>information functions\</bookmark_value\>\<bookmark_value\>Function Wizard; information\</bookmark_value\>\<bookmark_value\>functions; information functions\</bookmark_value\>

Information Functions

This category contains the Information functions.

To access this command...

Insert - Function - Category Information


The data in the following table serves as the basis for some of the examples in the function descriptions:

C

D

2

x value

y value

3

-5

-3

4

-2

0

5

-1

1

6

0

3

7

2

4

8

4

6

9

6

8


\<bookmark_value\>CELL function\</bookmark_value\>\<bookmark_value\>cell information\</bookmark_value\>\<bookmark_value\>information on cells\</bookmark_value\>

CELL

Returns information on address, formatting or contents of a cell.

Syntax

CELL(Info_type; Reference)

\<emph\>Info_type\</emph\> is the character string that specifies the type of information. The character string is always in English. Upper or lower case is optional.

Info_type

Meaning

COL

Returns the number of the referenced column.

Cell("COL";D2) returns 4.

ROW

Returns the number of the referenced row.

Cell("ROW";D2) returns 2.

SHEET

Returns the number of the referenced sheet.

Cell("Sheet";Sheet3.D2) returns 3.

ADDRESS

Returns the absolute address of the referenced cell.

CELL("ADDRESS";D2) returns $D$2.

CELL("ADDRESS";Sheet3.D2) returns $Sheet3.$D$2.

=CELL("ADDRESS";'X:\dr\test.ods'#$Sheet1.D2) returns 'file:///X:/dr/test.ods'#$Sheet1.$D$2.

FILENAME

Returns the file name and the sheet number of the referenced cell.

=CELL("FILENAME";D2) returns 'file:///X:/dr/own.ods'#$Sheet1, if the formula in the current document X:\dr\own.ods is located in Sheet1.

=CELL("FILENAME";'X:\dr\test.ods'#$Sheet1.D2) returns 'file:///X:/dr/test.ods'#$Sheet1.

COORD

Returns the complete cell address in Lotus™ notation.

CELL("COORD"; D2) returns $A:$D$2.

CELL("COORD"; Sheet3.D2) returns $C:$D$2.

CONTENTS

Returns the contents of the referenced cell, without any formatting.

TYPE

Returns the type of cell contents.

b = blank. empty cell

l = label. Text, result of a formula as text

v = value. Value, result of a formula as a number

WIDTH

Returns the width of the referenced column. The unit is the number of zeros (0) that fit into the column in the default text and the default size.

PREFIX

Returns the alignment of the referenced cell.

' = align left or left-justified

" = align right

^ = centered

\ = repeating (currently inactive)

PROTECT

Returns the status of the cell protection for the cell.

1 = cell is protected

0 = cell is not protected

FORMAT

Returns a character string that indicates the number format.

, = number with thousands separator

F = number without thousands separator

C = currency format

S = exponential representation, for example, 1.234+E56

P = percentage

In the above formats, the number of decimal places after the decimal separator is given as a number. Example: the number format #,##0.0 returns ,1 and the number format 00.000% returns P3

D1 = MMM-D-YY, MM-D-YY and similar formats

D2 = DD-MM

D3 = MM-YY

D4 = DD-MM-YYYY HH:MM:SS

D5 = MM-DD

D6 = HH:MM:SS AM/PM

D7 = HH:MM AM/PM

D8 = HH:MM:SS

D9 = HH:MM

G = All other formats

- (Minus) at the end = negative numbers are formatted in color

() (brackets) at the end = there is an opening bracket in the format code

COLOR

Returns 1, if negative values have been formatted in color, otherwise 0.

PARENTHESES

Returns 1 if the format code contains an opening bracket (, otherwise 0.


\<emph\>Reference\</emph\> (list of options) is the position of the cell to be examined. If \<emph\>Reference\</emph\> is a range, the cell moves to the top left of the range. If \<emph\>Reference\</emph\> is missing, LibreOffice Calc uses the position of the cell in which this formula is located. Microsoft Excel uses the reference of the cell in which the cursor is positioned.

\<bookmark_value\>CURRENT function\</bookmark_value\>

CURRENT

This function returns the result to date of evaluating the formula of which it is a part (in other words the result as far as that evaluation has got). Its main use is together with the STYLE() function to apply selected styles to a cell depending on the cell contents.

Syntax

CURRENT()

Example:

=1+2+CURRENT()

The example returns 6. The formula is calculated from left to right as: 1 + 2 equals 3, giving the result to date when CURRENT() is encountered; CURRENT() therefore yields 3, which is added to the original 3 to give 6.

=A2+B2+STYLE(IF(CURRENT()>10;”Red”;”Default”))

The example returns A2 + B2 (STYLE returns 0 here). If this sum is greater than 10, the style Red is applied to the cell. See the STYLE function for more explanation.

="choo"&CURRENT()

The example returns choochoo.

\<bookmark_value\>FORMULA function\</bookmark_value\>\<bookmark_value\>formula cells;displaying formulas in other cells\</bookmark_value\>\<bookmark_value\>displaying;formulas at any position\</bookmark_value\>

FORMULA

Displays the formula of a formula cell as a text string.

Syntax

FORMULA(reference)

\<emph\>reference\</emph\> is a reference to a cell containing a formula.

An invalid reference or a reference to a cell with no formula results in the error value #N/A.

Example:

If cell A8 contains the formula =SUM(1;2;3) then

FORMULA(A8) returns the text "=SUM(1;2;3)" (without the double quotes).

\<bookmark_value\>IF function\</bookmark_value\>

INFO

Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter.

Syntax

INFO("Type")

The following table lists the values for the text parameter Type and the return values of the INFO function.

Value for "Type"

Return value

"osversion"

Always "Windows (32-bit) NT 5.01", for compatibility reasons

"system"

The type of the operating system.
"WNT" for Microsoft Windows
"LINUX" for Linux
"SOLARIS" for Solaris

"release"

The product release identifier, for example "300m25(Build:9876)"

"numfile"

Always 1, for compatibility reasons

"recalc"

Current formula recalculation mode, either "Automatic" or "Manual" (localized into LibreOffice language)


Note Icon

Other spreadsheet applications may accept localized values for the Type parameter, but LibreOffice Calc will only accept the English values.


Example:

=INFO("release") returns the product release number of the LibreOffice in use.

=INFO(D5) with cell D5 containing a text string system returns the operation system type.

\<bookmark_value\>ISBLANK function\</bookmark_value\>\<bookmark_value\>blank cell contents\</bookmark_value\>\<bookmark_value\>empty cells; recognizing\</bookmark_value\>

ISBLANK

Returns TRUE if the reference to a cell is blank. This function is used to determine if the content of a cell is empty. A cell with a formula inside is not empty.

If an error occurs, the function returns a logical or numerical value.

Syntax

ISBLANK(value)

\<emph\>Value\</emph\> is the content to be tested.

Example:

ISBLANK(D2) returns FALSE as a result.

\<bookmark_value\>ISERR function\</bookmark_value\>\<bookmark_value\>error codes;controlling\</bookmark_value\>

ISERR

Tests for error conditions, except the #N/A error value, and returns TRUE or FALSE.

If an error occurs, the function returns a logical or numerical value.

Syntax

ISERR(value)

\<emph\>Value\</emph\> is any value or expression which is tested to see whether an error value other than #N/A is present.

Example:

ISERR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error.

ISERR(C9) where cell C9 contains =NA() returns FALSE, because ISERR() ignores the #N/A error.

\<bookmark_value\>ISERROR function\</bookmark_value\>\<bookmark_value\>recognizing;general errors\</bookmark_value\>

ISERROR

Tests for error conditions, including the #N/A error value, and returns TRUE or FALSE.

If an error occurs, the function returns a logical or numerical value.

Syntax

ISERROR(value)

\<emph\>Value\</emph\> is or refers to the value to be tested. ISERROR() returns TRUE if there is an error and FALSE if not.

Example:

ISERROR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error.

ISERROR(C9) where cell C9 contains =NA() returns TRUE.

\<bookmark_value\>ISERROR function\</bookmark_value\>\<bookmark_value\>recognizing;general errors\</bookmark_value\>

ISERROR

Returns the value if the cell does not contains an error value, or the alternative value if it does.

Syntax

IFERROR(Value;Alternate_value)

Value is the value or expression to be returned if it is not equal or results in an error.

Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an error.

Example:

ISERROR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error.

ISERROR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error.

\<bookmark_value\>ISEVEN function\</bookmark_value\>\<bookmark_value\>even integers\</bookmark_value\>

ISEVEN

Returns TRUE if the value is an even integer, or FALSE if the value is odd.

Syntax

ISEVEN(value)

\<emph\>Value\</emph\> is the value to be checked.

If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.

Example:

If you enter the value 642, TRUE will be returned as the result.

If you enter the value 642, TRUE will be returned as the result.

If you enter the value 642, TRUE will be returned as the result.

If you enter the value 642, TRUE will be returned as the result.

If you enter the value 642, TRUE will be returned as the result.

\<bookmark_value\>ISEVEN_ADD function\</bookmark_value\>

ISEVEN_ADD

Tests for even numbers. Returns 1 if the number divided by 2 returns a whole number.

Note Icon

The functions whose names end with _ADD or _EXCEL2003 return the same results as the corresponding Microsoft Excel 2003 functions without the suffix. Use the functions without suffix to get results based on international standards.


Syntax

ISEVEN_ADD(Number)

Number: the number to be tested.

Example:

=ISEVEN_ADD(5) returns 0.

ISNONTEXT(D9) returns TRUE.

\<bookmark_value\>ISFORMULA function\</bookmark_value\>\<bookmark_value\>recognizing formula cells\</bookmark_value\>\<bookmark_value\>formula cells;recognizing\</bookmark_value\>

ISFORMULA

Returns TRUE if a cell is a formula cell.

If an error occurs, the function returns a logical or numerical value.

Syntax

ISFORMULA(reference)

\<emph\>Reference\</emph\> indicates the reference to a cell in which a test will be performed to determine if it contains a formula.

Example:

ISFORMULA(C4) returns FALSE as a result.

\<bookmark_value\>ISLOGICAL function\</bookmark_value\>\<bookmark_value\>number formats;logical\</bookmark_value\>\<bookmark_value\>logical number formats\</bookmark_value\>

ISLOGICAL

Tests for a logical value (TRUE or FALSE).

If an error occurs, the function returns FALSE.

Syntax

ISLOGICAL(value)

Returns TRUE if \<emph\>Value\</emph\> is a logical value (TRUE or FALSE), and returns FALSE otherwise.

Example:

ISLOGICAL(99) returns FALSE, because 99 is a number, not a logical value.

ISLOGICAL(ISNA(D4)) returns TRUE whatever the contents of cell D4, because ISNA() returns a logical value.

\<bookmark_value\>ISNA function\</bookmark_value\>\<bookmark_value\>#N/A error;recognizing\</bookmark_value\>

ISNA

Returns TRUE if a cell contains the #N/A (value not available) error value.

If an error occurs, the function returns FALSE.

Syntax

ISNA(value)

\<emph\>Value\</emph\> is the value or expression to be tested.

Example:

ISNA(D3) returns FALSE as a result.

\<bookmark_value\>ISNA function\</bookmark_value\>\<bookmark_value\>#N/A error;recognizing\</bookmark_value\>

ISNA

Returns the value if the cell does not contains the #N/A (value not available) error value, or the alternative value if it does.

Syntax

IFNA(Value;Alternate_value)

Value is the value or expression to be returned if it is not equal or results in an #N/A error.

Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an #N/A error.

Example:

=IFNA(D3;D4) returns the value of D3 if D3 does not result in an #N/A error, or D4 if it does.

\<bookmark_value\>ISNONTEXT function\</bookmark_value\>\<bookmark_value\>cell contents;no text\</bookmark_value\>

ISNONTEXT

Tests if the cell contents are text or numbers, and returns FALSE if the contents are text.

If an error occurs, the function returns TRUE.

Syntax

ISNONTEXT(value)

\<emph\>Value\</emph\> is any value or expression where a test is performed to determine whether it is a text or numbers or a Boolean value.

Example:

ISNONTEXT(D2) returns FALSE.

ISNONTEXT(D9) returns TRUE.

\<bookmark_value\>ISNUMBER function\</bookmark_value\>\<bookmark_value\>cell contents;numbers\</bookmark_value\>

ISNUMBER

Returns TRUE if the value refers to a number.

If an error occurs, the function returns a logical or numerical value.

Syntax

ISNUMBER(value)

\<emph\>Value\</emph\> is any expression to be tested to determine whether it is a number or text.

Example:

ISNUMBER(C3) returns the result TRUE.

ISNUMBER(C2) returns FALSE as a result.

\<bookmark_value\>ISODD function\</bookmark_value\>\<bookmark_value\>odd integers\</bookmark_value\>

ISODD

Returns TRUE if the value is odd, or FALSE if the number is even.

Syntax

ISODD(value)

\<emph\>Value\</emph\> is the value to be checked.

If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.

Example:

If you enter the value 642, FALSE will be returned as the result.

If you enter the value 642, FALSE will be returned as the result.

If you enter the value 642, FALSE will be returned as the result.

If you enter the value 642, FALSE will be returned as the result.

\<bookmark_value\>ISODD_ADD function\</bookmark_value\>

ISODD_ADD

Returns TRUE (1) if the number does not return a whole number when divided by 2.

Note Icon

The functions whose names end with _ADD or _EXCEL2003 return the same results as the corresponding Microsoft Excel 2003 functions without the suffix. Use the functions without suffix to get results based on international standards.


Syntax

ISODD_ADD(Number)

Number: the number to be tested.

Example:

=ISODD_ADD(5) returns 1.

\<bookmark_value\>ISREF function\</bookmark_value\>\<bookmark_value\>references;testing cell contents\</bookmark_value\>\<bookmark_value\>cell contents;testing for references\</bookmark_value\>

ISREF

Tests if the argument is a reference. Returns TRUE if the argument is a reference, returns FALSE otherwise. When given a reference this function does not examine the value being referenced.

If an error occurs, the function returns a logical or numerical value.

Syntax

ISREF(value)

\<emph\>Value\</emph\> is the value to be tested, to determine whether it is a reference.

Example:

ISREF(C5) returns the result TRUE

=ISREF("abcdef") returns always FALSE because a text can never be a reference.

If you enter the value 642, TRUE will be returned as the result.

=ISREF(INDIRECT("A6")) returns TRUE, because INDIRECT is a function that returns a reference.

=ISREF(ADDRESS(1; 1; 2;"Sheet2")) returns FALSE, because ADDRESS is a function that returns a text, although it looks like a reference.

\<bookmark_value\>ISTEXT function\</bookmark_value\>\<bookmark_value\>cell contents;text\</bookmark_value\>

ISTEXT

Returns TRUE if the cell contents refer to text.

If an error occurs, the function returns FALSE.

Syntax

ISTEXT(value)

\<emph\>Value\</emph\> is a value, number, Boolean value, or an error value to be tested.

Example:

ISTEXT(D9) returns the result TRUE.

ISTEXT(C3) returns FALSE as a result.

\<bookmark_value\>N function\</bookmark_value\>

N

Returns the numeric value of the given parameter. Returns 0 if parameter is text or FALSE.

If an error occurs the function returns the error value.

Syntax

N(value)

Value is the parameter to be converted into a number. N() returns the numeric value if it can. It returns the logical values TRUE and FALSE as 1 and 0 respectively. It returns text as 0.

Example:

N(123) returns 123

N(TRUE) returns 1

N(FALSE) returns 0

N("abc") returns 0

=N(1/0) returns #DIV/0!

\<bookmark_value\>NA function\</bookmark_value\>\<bookmark_value\>#N/A error;assigning to a cell\</bookmark_value\>

NA

Returns the error value #N/A.

Syntax

NA()

Example:

NA() converts the contents of the cell into #N/A.

\<bookmark_value\>TYPE function\</bookmark_value\>

TYPE

Returns the type of value, where 1 = number, 2 = text, 4 = Boolean value, 8 = formula, 16 = error value, 64 = array.

If an error occurs, the function returns a logical or numerical value.

Syntax

TYPE(value)

Value is a specific value for which the data type is determined.

Example (see example table above)

TYPE(C2) returns 2 as a result.

TYPE(D9) returns 1 as a result.