IsEmpty (Recordset function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Template:Recordset:IsEmpty subtitle}} | {{Template:Recordset:IsEmpty subtitle}} | ||
<var>IsEmpty</var> returns a [[Enumerations#Using_Boolean_enumerations| | <var>IsEmpty</var> returns a <var>[[Enumerations#Using_Boolean_enumerations|Boolean Enumeration]]</var> whose value is <var>True</var> if the set is empty (has no records) and <var>False</var> if the set has records. | ||
==Syntax== | ==Syntax== | ||
{{Template:Recordset:IsEmpty syntax}} | {{Template:Recordset:IsEmpty syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%boolean</th> | <tr><th>%boolean</th> | ||
<td>A declared enumeration object of type <var> | <td>A declared enumeration object of type <var>Boolean</var> to contain the returned value of <var>IsEmpty</var>.</td></tr> | ||
<tr><th>recordset</th> | <tr><th>recordset</th> | ||
<td>An instantiated <var>Recordset</var> object variable. | <td>An instantiated <var>Recordset</var> object variable.</td></tr> | ||
</td></tr></table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul><li> Since it is much more efficient than testing the record count for 0, use <var>IsEmpty</var> when you simply need to test for an empty set. | <ul> | ||
when you need the number of records. | <li> Since it is much more efficient than testing the record count for 0, use <var>IsEmpty</var> when you simply need to test for an empty set. Use <var>[[Count (Recordset function)|Count]]</var> only when you need the number of records. | ||
</ul> | </ul> | ||
==See also== | ==See also== | ||
{{Template:Recordset:IsEmpty footer}} | {{Template:Recordset:IsEmpty footer}} | ||
Latest revision as of 23:40, 6 November 2012
Is Recordset empty? (Recordset class)
IsEmpty returns a Boolean Enumeration whose value is True if the set is empty (has no records) and False if the set has records.
Syntax
%boolean = recordset:IsEmpty
Syntax terms
| %boolean | A declared enumeration object of type Boolean to contain the returned value of IsEmpty. |
|---|---|
| recordset | An instantiated Recordset object variable. |
Usage notes
- Since it is much more efficient than testing the record count for 0, use IsEmpty when you simply need to test for an empty set. Use Count only when you need the number of records.