Commit 6135f076 authored by Max Kellermann's avatar Max Kellermann

playlist/cue/CueParser: update API documentation

parent 307964d8
...@@ -83,34 +83,33 @@ class CueParser { ...@@ -83,34 +83,33 @@ class CueParser {
/** /**
* A song that is completely finished and can be returned to * A song that is completely finished and can be returned to
* the caller via cue_parser_get(). * the caller via Get().
*/ */
std::unique_ptr<DetachedSong> finished; std::unique_ptr<DetachedSong> finished;
/** /**
* Tracks whether cue_parser_finish() has been called. If * Tracks whether Finish() has been called. If true, then all
* true, then all remaining (partial) results will be * remaining (partial) results will be delivered by Get().
* delivered by cue_parser_get().
*/ */
bool end = false; bool end = false;
public: public:
/** /**
* Feed a text line from the CUE file into the parser. Call * Feed a text line from the CUE file into the parser. Call
* cue_parser_get() after this to see if a song has been finished. * Get() after this to see if a song has been finished.
*/ */
void Feed(const char *line); void Feed(const char *line);
/** /**
* Tell the parser that the end of the file has been reached. Call * Tell the parser that the end of the file has been reached. Call
* cue_parser_get() after this to see if a song has been finished. * Get() after this to see if a song has been finished.
* This procedure must be done twice! * This procedure must be done twice!
*/ */
void Finish(); void Finish();
/** /**
* Check if a song was finished by the last cue_parser_feed() or * Check if a song was finished by the last Feed() or Finish()
* cue_parser_finish() call. * call.
* *
* @return a song object that must be freed by the caller, or NULL if * @return a song object that must be freed by the caller, or NULL if
* no song was finished at this time * no song was finished at this time
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment