Functions | |
QUVIcode | quvi_supported (quvi_t quvi, char *url) |
Check whether the library could parse the URL. | |
QUVIcode | quvi_next_supported_website (quvi_t quvi, char **domain, char **formats) |
Return next supported website. | |
QUVIcode | quvi_next_host (char **domain, char **formats) |
Next supported host. | |
char * | quvi_strerror (quvi_t quvi, QUVIcode code) |
Return a string describing the error code. | |
char * | quvi_version (QUVIversion type) |
Return libquvi version. | |
void | quvi_free (void *ptr) |
Free allocated memory. |
Check whether the library could parse the URL.
The library checks the URL with each website script to see whether it could parse the URL.
This function is designed to work without an Internet connection. This design has a drawback: most shortened URLs (e.g. is.gd, bit.ly, goo.gl, etc.) will fail with this function (QUVI_NOSUPPORTED). Such URLs would normally have to be resolved over an Internet connection. See also the notes.
quvi | Handle to session |
url | Null-terminated string to an URL |
Return next supported website.
This function can be used to iterate the supported websites.
quvi | Handle to a session |
domain | Pointer to a null-terminated string (e.g. "youtube.com") |
formats | Pointer to a null-terminated string (e.g. "default|best|hq|hd") |
Example:
while (quvi_next_supported_website(quvi, &domain, &formats) == QUVI_OK) { printf("%s\t%s\n", domain, formats); quvi_free(domain); quvi_free(formats); }
QUVIcode quvi_next_host | ( | char ** | domain, |
char ** | formats | ||
) |
Next supported host.
Iterate the list of the supported hosts.
domain | Pointer to a null-terminated string |
formats | Pointer to a null-terminated string |
Return a string describing the error code.
quvi | Handle to a libquvi session |
code | Error code |
Example:
quvi_t quvi; QUVIcode rc = quvi_init(&quvi); if (rc != QUVI_OK) { fprintf(stderr, "error: %s\n", quvi_strerror(quvi,rc)); exit (rc); } quvi_close(&quvi);
char* quvi_version | ( | QUVIversion | type | ) |
Return libquvi version.
type | Version type |
Example:
puts( quvi_version(QUVI_VERSION_LONG) );
void quvi_free | ( | void * | ptr | ) |