Difference between revisions of "Documentation/How Tos/Calc: COUNTIF function"
m (regex link in text) |
m |
||
| Line 11: | Line 11: | ||
<tt>'''condition'''</tt> is or refers to a text string which has the following format: | <tt>'''condition'''</tt> is or refers to a text string which has the following format: | ||
| − | <tt>'''comparator'''</tt> <tt>'''value'''</tt> where | + | :<tt>'''comparator'''</tt> <tt>'''value'''</tt> where |
| − | <tt>'''comparator'''</tt> is one of <tt>'''>'''</tt>, <tt>'''<nowiki><</nowiki>'''</tt>, <tt>'''>='''</tt>, <tt>'''<nowiki><=</nowiki>'''</tt>, <tt>'''<nowiki>=</nowiki>'''</tt>, <tt>'''<nowiki><></nowiki>'''</tt> (if <tt>'''comparator'''</tt> is omitted <tt>'''<nowiki>=</nowiki>'''</tt> is assumed ), and | + | ::<tt>'''comparator'''</tt> is one of <tt>'''>'''</tt>, <tt>'''<nowiki><</nowiki>'''</tt>, <tt>'''>='''</tt>, <tt>'''<nowiki><=</nowiki>'''</tt>, <tt>'''<nowiki>=</nowiki>'''</tt>, <tt>'''<nowiki><></nowiki>'''</tt> (if <tt>'''comparator'''</tt> is omitted <tt>'''<nowiki>=</nowiki>'''</tt> is assumed ), and |
| − | <tt>'''value'''</tt> is the value (number or text) to be compared. | + | ::<tt>'''value'''</tt> is the value (number or text) to be compared. |
For example the condition “<tt>'''>4'''</tt>” tests if the contents of the cell are greater than 4. | For example the condition “<tt>'''>4'''</tt>” tests if the contents of the cell are greater than 4. | ||
Revision as of 19:00, 30 November 2007
COUNTIF
Counts the number of cells in a range that meet a specified condition.
Syntax:
COUNTIF(test_range; condition)
This function counts those cells in the range test_range that meet the condition.
condition is or refers to a text string which has the following format:
- comparator value where
- comparator is one of >, <, >=, <=, =, <> (if comparator is omitted = is assumed ), and
- value is the value (number or text) to be compared.
For example the condition “>4” tests if the contents of the cell are greater than 4.
Facilities to compare text for equality or inequality (= or <>) are very powerful, but some care must be taken. You must choose the desired behaviour from the Tools menu – Options - OpenOffice.org Calc - Calculate:
If the checkbox is ticked for search criteria = and <> must apply to whole cells, then the condition “red” will match only red; if unticked it will match red, Fred, red herring.
If the checkbox is ticked for Enable regular expressions in formulas, the condition will match using regular expressions - so for example "r.d" will match red, rod, rid, and "red.*" will match red, redraw, redden.
At present the checkbox for Case sensitive has no effect (no attention is paid to case) - but this may be changed in future, so please do not rely on this behaviour.
Blank (empty) cells in test_range are ignored (they never satisfy the condition).
condition can only specify one single condition. See Conditional Counting and Summation for more information.
Example:
| COUNTIF(C2:C8; ">=20") | returns the number of cells in C2:C8 whose contents are numerically greater than or equal to 20. |
| COUNTIF(C2:C8; F1) | where F1 contains the text >=20 returns the same number. |
| COUNTIF(C2:C8; "<"&F2) | where F2 contains 20 returns the number of cells in C2:C8 whose contents are numerically less than 20. |
| COUNTIF(A2:A8; ">=P") | returns the number of cells in A2:A8 whose contents begin with the letter P or later in the alphabet. |
| COUNTIF(B2:B8;"red") | returns the number of cells in B2:B8 containing red, but this number may depend on the option settings discussed above. |
See also:
SUMIF function, COUNTBLANK function
