User Guide

366 Components Dictionary
DataSet.findFirst()
Availability
Flash Player 7.
Edition
Flash MX Professional 2004.
Usage
dataSetInstance.findFirst(searchValues)
Parameters
searchValues An array that contains one or more field values to be found within the
current sort.
Returns
Returns true if the items are found; otherwise, returns false.
Description
Method; searches the current view of the collection for the first item with the field values
specified by
searchValues. Which items are in the current view depends on any current filter
and range settings.
The values specified by
searchValues must be in the same order as the field list specified by
the current sort (see the example below).
Conversion of the data specified is based on the underlying field’s type. For example, if the
search value specified is
["05-02-02"], the underlying date field is used to convert the value
with the date’s
setAsString() method. If the value specified is [new Date().getTime()],
the date’s
setAsNumber() method is used.
Example
The following example uses DataSet.find() to search for an item in the current collection
whose
name and id fields contain the values "Bobby" and 105, respectively. If found,
DataSet.getItemId() is used to get the unique identifier for that item, and
DataSet.locateById() is used to position the current iterator at that item.