IsEmpty (SortedRecordset function): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
m (fix "using boolean enumerations" link) |
||
| Line 1: | Line 1: | ||
{{Template:SortedRecordset:IsEmpty subtitle}} | {{Template:SortedRecordset:IsEmpty subtitle}} | ||
<var>IsEmpty</var> returns a [[Enumerations#Using_Boolean_enumerations|"Boolean Enumeration"]] whose value is <code>True</code> if the set is empty (has no records), and is <code>False</code> if the set has records. | |||
==Syntax== | ==Syntax== | ||
{{Template:SortedRecordset:IsEmpty syntax}} | {{Template:SortedRecordset:IsEmpty syntax}} | ||
| Line 9: | Line 7: | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%bool</th> | <tr><th>%bool</th> | ||
<td>A declared enumeration object of type <var>Boolean</var> to contain the returned value of <var>IsEmpty</var>. | <td>A declared enumeration object of type <var>[[Boolean]]</var> to contain the returned value of <var>IsEmpty</var>.</td></tr> | ||
</td></tr> | |||
<tr><th>%srecs</th> | <tr><th>%srecs</th> | ||
<td>A reference to an instance of a <var>SortedRecordset</var> object. | <td>A reference to an instance of a <var>SortedRecordset</var> object. | ||
</td></tr></table> | |||
==Usage Note== | ==Usage Note== | ||
<ul> | <ul> | ||
<li>For convenience, | <li>For convenience, use <var>IsEmpty</var> when you simply need to test for an empty set of records; it is more efficient as testing the record <var>Count</var> for 0. Use the <var>[[Count (SortedRecordset property)|Count]]</var> property when you need the number of records. | ||
use <var>IsEmpty</var> when you simply need to test for an empty set of records; | |||
it is | |||
Use the <var>[[Count (SortedRecordset property)|Count]]</var> property | |||
when you need the number of records. | |||
</ul> | </ul> | ||
==See also== | ==See also== | ||
{{Template:SortedRecordset:IsEmpty footer}} | {{Template:SortedRecordset:IsEmpty footer}} | ||
Revision as of 09:24, 19 May 2011
Is this SortedRecordset empty? (SortedRecordset class)
IsEmpty returns a "Boolean Enumeration" whose value is True if the set is empty (has no records), and is False if the set has records.
Syntax
%boolean = sortedRecordset:IsEmpty
Syntax terms
| %bool | A declared enumeration object of type Boolean to contain the returned value of IsEmpty. |
|---|---|
| %srecs | A reference to an instance of a SortedRecordset object. |
Usage Note
- For convenience, use IsEmpty when you simply need to test for an empty set of records; it is more efficient as testing the record Count for 0. Use the Count property when you need the number of records.