Difference between revisions of "Documentation/How Tos/Calc: COLUMNS function"
From Apache OpenOffice Wiki
< Documentation | How Tos
((Syntax)) |
(included 'use of multiple ranges') |
||
Line 2: | Line 2: | ||
== COLUMNS == | == COLUMNS == | ||
− | Returns the number of columns in a given | + | Returns the number of columns in a given reference. |
=== Syntax: === | === Syntax: === | ||
− | <tt>'''COLUMNS( | + | <tt>'''COLUMNS(reference)'''</tt> |
− | : <tt>''' | + | : <tt>'''reference'''</tt> may be given either explicitly (eg <tt>'''A3:B5'''</tt>) or by name (eg <tt>'''myref'''</tt>). |
+ | |||
+ | : It is possible to define a name to represent more than one range (eg by entering <tt>'''$A$1:$A$3;$C$1:$C$4'''</tt> in the '''Assigned To''' box of the '''Insert - Names - Define...''' dialog). In this case <tt>'''COLUMNS'''</tt> sums the number of columns in each range, irrespective of any duplication of columns. | ||
=== Example: === | === Example: === | ||
Line 18: | Line 20: | ||
<tt>'''COLUMNS(D8)'''</tt> | <tt>'''COLUMNS(D8)'''</tt> | ||
: returns <tt>'''1'''</tt>; <tt>'''D8'''</tt> is interpreted as a one cell range, with a single column (column D). | : returns <tt>'''1'''</tt>; <tt>'''D8'''</tt> is interpreted as a one cell range, with a single column (column D). | ||
+ | |||
+ | <tt>'''COLUMNS(myref)'''</tt> | ||
+ | : where <tt>'''myref'''</tt> has been defined as the multiple range <tt>'''$A$1:$A$3;$C$1:$D$4'''</tt>, returns <tt>'''3'''</tt>. | ||
=== See also: === | === See also: === | ||
'''[[Documentation/How_Tos/Calc: ROWS function|ROWS]]''', | '''[[Documentation/How_Tos/Calc: ROWS function|ROWS]]''', | ||
− | '''[[Documentation/How_Tos/Calc: SHEETS function|SHEETS]]''' | + | '''[[Documentation/How_Tos/Calc: SHEETS function|SHEETS]]''', |
+ | '''[[Documentation/How_Tos/Calc: AREAS function|AREAS]]''' | ||
'''[[Documentation/How_Tos/Calc: Information functions|Information functions]]''', | '''[[Documentation/How_Tos/Calc: Information functions|Information functions]]''', | ||
'''[[Documentation/How_Tos/Calc: Spreadsheet functions|Spreadsheet functions]]''' | '''[[Documentation/How_Tos/Calc: Spreadsheet functions|Spreadsheet functions]]''' |
Revision as of 19:12, 19 February 2008
COLUMNS
Returns the number of columns in a given reference.
Syntax:
COLUMNS(reference)
- reference may be given either explicitly (eg A3:B5) or by name (eg myref).
- It is possible to define a name to represent more than one range (eg by entering $A$1:$A$3;$C$1:$C$4 in the Assigned To box of the Insert - Names - Define... dialog). In this case COLUMNS sums the number of columns in each range, irrespective of any duplication of columns.
Example:
COLUMNS(A3:B5)
- returns 2; there are two columns in this range, namely columns A and B.
COLUMNS(G4:H4)
- returns 2; there are two columns in this range, namely columns G and H.
COLUMNS(D8)
- returns 1; D8 is interpreted as a one cell range, with a single column (column D).
COLUMNS(myref)
- where myref has been defined as the multiple range $A$1:$A$3;$C$1:$D$4, returns 3.