Database Advanced Search

Functions
void	mpd_database_search_add_constraint (MpdObj *mi, mpd_TagItems field, const char *value)
void	mpd_database_search_start (MpdObj *mi, int exact)
void	mpd_database_search_field_start (MpdObj *mi, mpd_TagItems field)
MpdData *	mpd_database_search_commit (MpdObj *mi)

Detailed Description

The following functions provide an interface to the improved search capabilities of mpd 0.12.0.

Function Documentation

mpd_database_search_add_constraint()

void mpd_database_search_add_constraint	(	MpdObj *	mi,
		mpd_TagItems	field,
		const char *	value
	)

Parameters

mi	A MpdObj
field	A mpd_TagItems
value	a string that field needs to match

Adds a constraint to the search

mpd_database_search_commit()

MpdData* mpd_database_search_commit

(

MpdObj *

mi

)

Parameters

mi

A MpdObj

Commits the search and gathers the result in a MpdData list.

Returns

a MpdData list with the search result, or NULL when nothing is found

mpd_database_search_field_start()

void mpd_database_search_field_start	(	MpdObj *	mi,
		mpd_TagItems	field
	)

Parameters

mi	a MpdObj
field	a mpd_TagItems

Starts a field search, eg. if you want a list of all albums, you do;

mpd_database_search_field_start(mi, MPD_TAG_ITEM_ALBUM);
data = mpd_database_search_commit(mi);

You can add constraints using mpd_database_search_add_constraint, for example if you want all albums by eric clapton:

mpd_database_search_field_start(mi, MPD_TAG_ITEM_ALBUM);
mpd_database_search_add_constraint(mi, MPD_TAG_ITEM_ARTIST, "Eric Clapton");
data = mpd_database_search_commit(mi);

mpd_database_search_start()

void mpd_database_search_start	(	MpdObj *	mi,
		int	exact
	)

Parameters

mi	A MpdObj
exact	a boolean indicating if the search is fuzzy or exact

Starts a search, you can add "constraints" by calling mpd_database_search_add_constraint For Example if you want all songs by Eric Clapton you could do:

mpd_database_search_start(mi, TRUE);
mpd_database_search_add_constraint(mi, MPD_TAG_ITEM_ARTIST, "Eric Clapton");
data= mpd_database_search_commit(mi);

If you only want the songs from the album unplugged:

mpd_database_search_start(mi, TRUE);
mpd_database_search_add_constraint(mi, MPD_TAG_ITEM_ARTIST, "Eric Clapton");
mpd_database_search_add_constraint(mi, MPD_TAG_ITEM_ALBUM, "Unplugged");
data= mpd_database_search_commit(mi);

This function requires mpd 0.12.0 or higher