Common return values for the "find" method

Overview

The find command typically returns an array of items and a few other variables intended to allow you to generate paging and any other related UI when listing items of any kind.

The following fields are found in a range of Ajax interfaces, as noted in each individual Method's documentation.

VariableValuesDescription
more_availableBooleanIf there are more Content Items to be returned after the current record set that were not returned due to paging or some other limit, then this will be true. Otherwise it is false.

This is commonly used for deciding whether or not to show the "Next Page" link when listing Content Items.
total_itemsNon-negative IntegerThe total number of Content Items that matched the request made, regardless of any paging or limits in force.

This is commonly used for showing how many results there are matching a particular query/search when paging, e.g. "1-20 of 650" where 650 is the value returned within the total_items variable.
number_of_pagesNon-negative IntegerThe total number of pages of results based on the current settings used for the original request.

This is most useful when simply using the default value for items_per_page, so that your calling script(s) can generate their paging as needed, without the need to know the specifics about the limits in play.