diff options
Diffstat (limited to 'include/quickmedia/HtmlSearch.h')
| -rw-r--r-- | include/quickmedia/HtmlSearch.h | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/include/quickmedia/HtmlSearch.h b/include/quickmedia/HtmlSearch.h index 09a17e2..b3b2eaa 100644 --- a/include/quickmedia/HtmlSearch.h +++ b/include/quickmedia/HtmlSearch.h @@ -17,11 +17,17 @@ typedef struct { const void *doc; } QuickMediaHtmlSearch; -/* Returns NULL if attribute doesn't exist or if it doesn't have any value */ +/* + Returns NULL if attribute doesn't exist or if it doesn't have any value. + The result is only valid within the callback function scope. +*/ const char* quickmedia_html_node_get_attribute_value(QuickMediaHtmlNode *self, const char *attribute_name); -/* Returns StringView where data is NULL and size is 0 if node doesn't have any text */ -QuickMediaStringView quickmedia_html_node_get_text(QuickMediaHtmlNode *self); +/* + Returns NULL if the node doesn't have any text. + The result is only valid within the callback function scope. +*/ +const char* quickmedia_html_node_get_text(QuickMediaHtmlNode *self); /* @node is only valid within the callback function scope */ typedef void (*QuickMediaHtmlSearchResultCallback)(QuickMediaHtmlNode *node, void *userdata); @@ -29,6 +35,7 @@ typedef void (*QuickMediaHtmlSearchResultCallback)(QuickMediaHtmlNode *node, voi int quickmedia_html_search_init(QuickMediaHtmlSearch *self, const char *html_source); void quickmedia_html_search_deinit(QuickMediaHtmlSearch *self); +/* Non-standard xpath. Doesn't use '@' symbol for accessing properties */ int quickmedia_html_find_nodes_xpath(QuickMediaHtmlSearch *self, const char *xpath, QuickMediaHtmlSearchResultCallback result_callback, void *userdata); #ifdef __cplusplus |