count()
Get the number of elements that are contained in an API instance.
Description
If can sometimes be useful to know how many items are contained in an API's result set - a function that is provided by this method.
It is important to note that the length
property cannot simply be reliably used itself to determine if the API result set contains any elements or not as the DataTables API is multi-table aware and the result set consists of nested arrays. Therefore we must flatten arrays before being able to use the length
property. This method does exactly that (i.e. it is a shortcut for api.flatten().length
).
Type
function count()
- Description:
Get the number of entries in an API instance's result set, regardless of multi-table grouping (e.g. any data, selected rows, etc).
- Returns:
The number of items in the API instance's result set
Examples
Count how many rows there are with the class selected
:
var table = new DataTable('#myTable');
alert('Rows ' + table.rows('.selected').count() + ' are selected');
Count the number of rows in a table :
var table = new DataTable('#myTable');
if (!table.rows().count()) {
alert('Empty table');
}
Related
The following options are directly related and may also be useful in your application development.