search()

Search a media source for media nodes that have metadata matching a search string.

Synopsis:

#include <qplayer/qplayer.h>
 
void search( SearchCommand *command );

Arguments:

command
A pointer to a SearchCommand object that specifies the media source to search, the search string for filtering the results, and other operation parameters. This object will return the operation results (i.e., the results media node) when requested.

Description:

Search a media source for media nodes that have metadata matching a search string. The media source to search, the search string, and the metadata fields to compare against the search string are specified in the SearchCommand object referenced in command.

The search operation returns a single results node, which you must then browse to view the individual media nodes in the results. When your client receives the complete signal, it can call the result() function on the command object to retrieve the results node. Note that the search results may include all types of media files—audio tracks, videos, and photos.