ETVDB
0.6.0
ETVDB is a tool and a library to get data from The TV Database (TVDB)
|
Overall Episode Functions. More...
Functions | |
EAPI Eina_List * | etvdb_episodes_get (Series *s) |
Get all Episodes of a Series. More... | |
EAPI Episode * | etvdb_episode_airs_next_get (Series *s, char *date) |
Get the Episode that airs next. More... | |
EAPI Episode * | etvdb_episode_by_date_get (Series *s, const char *date) |
Get episode data for a specific date. More... | |
EAPI Episode * | etvdb_episode_by_id_get (uint32_t id, Series **s) |
Get episode data for one specific Episode. More... | |
EAPI Episode * | etvdb_episode_by_number_get (Series *s, int season, int episode) |
Get episode data for one specific Episode. More... | |
EAPI void | etvdb_episode_free (Episode *e) |
Free a Episode structure. More... | |
EAPI Episode * | etvdb_episode_from_series_get (Series *s, int season, int episode) |
Get Episode data from Series data. More... | |
EAPI Episode * | etvdb_episode_latest_aired_get (Series *s, char *date) |
Get the Episode that aired most recently. More... | |
Overall Episode Functions.
These functions retrieve general episode data
Get the Episode that airs next.
This function returns the Episode that airs next after today or a given date.
The date string has to be in an ISO 8601 format and contain only the date. Behaviour for any other input is undefined. Example: 2013-03-28
s | Series data |
date | a string containing an ISO 8601 date or NULL for today |
Get episode data for a specific date.
This function will retrieve the data for one episode, that first aired at a specific date.
It will NOT fetch any data, so the passed Series structure has to be fully initialized, e.g. with etvdb_series_by_id_get.
s | Fully initialized TVDB Series structure. |
date | a ISO 8601 date string, e.g. "2014-05-25" |
Get episode data for one specific Episode.
This function will retreive the data for one episode, according to its episode ID.
You may notice that unlike all other episode functions this one uses the Series argument differently. This is intentional, because this function is unique in that it can initialize a Series structure on it's own, since the TVDB Episode ID does not require to know the Series beforehand.
id | TVDB ID of a episode |
s | TVDB Series structure. If necessary it will be initialized. May NOT be NULL! |
Get episode data for one specific Episode.
This function will retreive the data for one episode, according to its season and episode number.
s | initialized TVDB Series structure |
season | season number of the episode |
episode | episode number in the season |
EAPI void etvdb_episode_free | ( | Episode * | e | ) |
Free a Episode structure.
This function frees a Episode structure and its data. Note that a referenced parent series won't be freed.
e | pointer to Episode structure |
Get Episode data from Series data.
This function will return a pointer to Episode data inside a initialized Series struct. It can also get special episode by passing 0 as season number.
s | Series data |
season | season number, 0 for specials |
episode | episode number |
Get the Episode that aired most recently.
This function returns the Episode that initially aired last before today or a given date.
The date string has to be in an ISO 8601 format and contain only the date. Behaviour for any other input is undefined. Example: 2013-03-28
s | Series data |
date | a string containing an ISO 8601 date or NULL for today |
EAPI Eina_List* etvdb_episodes_get | ( | Series * | s | ) |
Get all Episodes of a Series.
This function takes a etvdb Series struct and retrieves all episodes for this series. This list will contain all episodes without being structured as seasons. If you don't require the list specifically, it is suggested to use etvdb_series_populate() instead.
s | initialized TVDB Series structure |