2
* Copyright (C) 2003-2009 The Music Player Daemon Project
3
* http://www.musicpd.org
5
* This program is free software; you can redistribute it and/or modify
6
* it under the terms of the GNU General Public License as published by
7
* the Free Software Foundation; either version 2 of the License, or
8
* (at your option) any later version.
10
* This program is distributed in the hope that it will be useful,
11
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13
* GNU General Public License for more details.
15
* You should have received a copy of the GNU General Public License along
16
* with this program; if not, write to the Free Software Foundation, Inc.,
17
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20
#ifndef SONG_STICKER_H
21
#define SONG_STICKER_H
31
* Returns one value from a song's sticker record. The caller must
32
* free the return value with g_free().
35
sticker_song_get_value(const struct song *song, const char *name);
38
* Sets a sticker value in the specified song. Overwrites existing
42
sticker_song_set_value(const struct song *song,
43
const char *name, const char *value);
46
* Deletes a sticker from the database. All values are deleted.
49
sticker_song_delete(const struct song *song);
52
* Deletes a sticker value. Does nothing if the sticker did not
56
sticker_song_delete_value(const struct song *song, const char *name);
59
* Loads the sticker for the specified song.
61
* @param song the song object
62
* @return a sticker object, or NULL on error or if there is no sticker
65
sticker_song_get(const struct song *song);
68
* Finds stickers with the specified name below the specified
71
* @param directory the base directory to search in
72
* @param name the name of the sticker
73
* @return true on success (even if no sticker was found), false on
77
sticker_song_find(struct directory *directory, const char *name,
78
void (*func)(struct song *song, const char *value,