Difference between revisions of "Documentation/How Tos/Calc: COLUMNS function"

From Apache OpenOffice Wiki
Jump to: navigation, search
((Syntax))
(included 'use of multiple ranges')
Line 2: Line 2:
  
 
== COLUMNS ==
 
== COLUMNS ==
Returns the number of columns in a given range.
+
Returns the number of columns in a given reference.
  
 
=== Syntax: ===
 
=== Syntax: ===
<tt>'''COLUMNS(range)'''</tt>
+
<tt>'''COLUMNS(reference)'''</tt>
  
: <tt>'''range'''</tt> is a range of cells, given either explicitly (<tt>'''A3:B5'''</tt>) or by name (<tt>'''myrangename'''</tt>) if a range name has been defined.
+
: <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.

See also:

ROWS, SHEETS, AREAS

Information functions, Spreadsheet functions

Personal tools