oysteikt/mpd
0
0
Fork 0
Code Issues Pull Requests Releases Activity

db/Interface: clarify GetSong() error handling

Browse Source
This commit is contained in:
Max Kellermann
2017-02-08 09:50:30 +01:00
parent 4f0fe66f69
commit c1fa5279f4
1 changed files with 5 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
src/db/Interface.hxx
View File

@@ -69,8 +69,13 @@ public:
* Look up a song (including tag data) in the database. When * Look up a song (including tag data) in the database. When
* you don't need this anymore, call ReturnSong(). * you don't need this anymore, call ReturnSong().
* *
* Throws std::runtime_error (or its derivative
* #DatabaseError) on error. "Not found" is an error that
* throws DatabaseErrorCode::NOT_FOUND.
*
* @param uri_utf8 the URI of the song within the music * @param uri_utf8 the URI of the song within the music
* directory (UTF-8) * directory (UTF-8)
* @return a pointer that must be released with ReturnSong()
*/ */
virtual const LightSong *GetSong(const char *uri_utf8) const = 0; virtual const LightSong *GetSong(const char *uri_utf8) const = 0;