| Top |
#define FEED_CHANNEL_CLASS(c) (G_TYPE_CHECK_CLASS_CAST ((c), GRSS_FEED_CHANNEL_TYPE, GrssFeedChannelClass))
GrssFeedChannel * grss_feed_channel_new ();
Allocates a new GrssFeedChannel.
GrssFeedChannel *
grss_feed_channel_new_with_source (gchar *source);
Allocates a new GrssFeedChannel and assign it the given remote source.
GrssFeedChannel * grss_feed_channel_new_from_xml (xmlDocPtr doc,GError **error);
Allocates a new GrssFeedChannel and init it with contents found in specified XML document.
GrssFeedChannel * grss_feed_channel_new_from_memory (const gchar *data,GError **error);
Allocates a new GrssFeedChannel and init it with contents found in specified memory block.
GrssFeedChannel * grss_feed_channel_new_from_file (const gchar *path,GError **error);
Allocates a new GrssFeedChannel and init it with contents found in specified file.
void grss_feed_channel_set_format (GrssFeedChannel *channel,gchar *format);
To assign a file format to the feed.
const gchar *
grss_feed_channel_get_format (GrssFeedChannel *channel);
Retrieves the file format of channel
.
gboolean grss_feed_channel_set_source (GrssFeedChannel *channel,gchar *source);
To assign the URL where to fetch the feed.
const gchar *
grss_feed_channel_get_source (GrssFeedChannel *channel);
Retrieves URL where to fetch the channel
.
void grss_feed_channel_set_title (GrssFeedChannel *channel,gchar *title);
To set a title to the channel
.
const gchar *
grss_feed_channel_get_title (GrssFeedChannel *channel);
Retrieves title of the channel
.
gboolean grss_feed_channel_set_homepage (GrssFeedChannel *channel,gchar *homepage);
To set the homepage of the site the channel
belongs.
const gchar *
grss_feed_channel_get_homepage (GrssFeedChannel *channel);
Retrieves the homepage of the site for which channel
is the feed.
void grss_feed_channel_set_description (GrssFeedChannel *channel,gchar *description);
To set the description of channel
.
const gchar *
grss_feed_channel_get_description (GrssFeedChannel *channel);
Retrieves the description of channel
.
gboolean grss_feed_channel_set_image (GrssFeedChannel *channel,gchar *image);
To set a rappresentative image to channel
.
const gchar *
grss_feed_channel_get_image (GrssFeedChannel *channel);
Retrieves the URL of the image assigned to the channel.
gboolean grss_feed_channel_set_icon (GrssFeedChannel *channel,gchar *icon);
To set the URL of the icon rappresenting channel
.
const gchar *
grss_feed_channel_get_icon (GrssFeedChannel *channel);
Retrieves URL of the favicon of the channel (and/or the website for which this is the feed).
void grss_feed_channel_set_language (GrssFeedChannel *channel,gchar *language);
To set the language of channel
.
const gchar *
grss_feed_channel_get_language (GrssFeedChannel *channel);
Retrieves the language of the channel
.
void grss_feed_channel_set_category (GrssFeedChannel *channel,gchar *category);
To set the category of the channel
.
const gchar *
grss_feed_channel_get_category (GrssFeedChannel *channel);
Retrieves category of the channel
.
gboolean grss_feed_channel_set_pubsubhub (GrssFeedChannel *channel,gchar *hub);
To set information about PubSubHubbub for the channel. To unset the hub,
pass NULL as parameter.
gboolean grss_feed_channel_get_pubsubhub (GrssFeedChannel *channel,gchar **hub);
Retrieves information about the PubSubHubbub hub of the channel.
void grss_feed_channel_set_rsscloud (GrssFeedChannel *channel,gchar *path,gchar *protocol);
To set information about RSSCloud notifications for the channel.
gboolean grss_feed_channel_get_rsscloud (GrssFeedChannel *channel,gchar **path,gchar **protocol);
Retrieves information about the RSSCloud coordinates of the channel.
void grss_feed_channel_set_copyright (GrssFeedChannel *channel,gchar *copyright);
To set the copyright of the feed.
const gchar *
grss_feed_channel_get_copyright (GrssFeedChannel *channel);
Retrieves indications about the copyright.
void grss_feed_channel_set_editor (GrssFeedChannel *channel,GrssPerson *editor);
To set the editor of the channel
.
GrssPerson *
grss_feed_channel_get_editor (GrssFeedChannel *channel);
Retrieves reference to the editor or the channel
.
void grss_feed_channel_add_contributor (GrssFeedChannel *channel,GrssPerson *contributor);
To add a contributor to the channel
.
const GList *
grss_feed_channel_get_contributors (GrssFeedChannel *channel);
Retrieves reference to the contributors of the channel
.
void grss_feed_channel_add_cookie (GrssFeedChannel *channel,SoupCookie *cookie);
To add a cookie related to the channel
, will be involved in HTTP sessions
while fetching it. More cookie can be added to every GrssFeedChannel
GSList *
grss_feed_channel_get_cookies (GrssFeedChannel *channel);
Retrieves reference to the HTML cookies of the channel
.
The list and the individual cookies should all be freed after use.
You can use soup_cookies_free.
void grss_feed_channel_set_webmaster (GrssFeedChannel *channel,gchar *webmaster);
To assign a webmaster to the channel
.
const gchar *
grss_feed_channel_get_webmaster (GrssFeedChannel *channel);
Retrieves reference to the webmaster of the feed.
void grss_feed_channel_set_generator (GrssFeedChannel *channel,gchar *generator);
To set information about the software generator of channel
.
const gchar *
grss_feed_channel_get_generator (GrssFeedChannel *channel);
Retrieves information about the feed's software generator.
void grss_feed_channel_set_gzip_compression (GrssFeedChannel *channel,gboolean value);
Set the GZIP compression for the channel to on or off.
gboolean
grss_feed_channel_get_gzip_compression
(GrssFeedChannel *channel);
GZIP compression of the channel is either on or off.
void grss_feed_channel_set_publish_time (GrssFeedChannel *channel,time_t publish);
To set the time of publishing for the feed.
time_t
grss_feed_channel_get_publish_time (GrssFeedChannel *channel);
Retrieves the publishing time of channel
.
void grss_feed_channel_set_update_time (GrssFeedChannel *channel,time_t update);
To set the latest update time of channel
.
time_t
grss_feed_channel_get_update_time (GrssFeedChannel *channel);
Retrieves the update time of channel
.
time of the feed's latest update. If this value was not set
(with grss_feed_channel_set_update_time()) returns
grss_feed_channel_get_publish_time().
void grss_feed_channel_set_update_interval (GrssFeedChannel *channel,int minutes);
To set the update interval for channel
.
int
grss_feed_channel_get_update_interval (GrssFeedChannel *channel);
Retrieves the update interval for the feed. Pay attention to the fact the
value can be unset, and the function returns 0: in this case the caller
must manually set a default update interval with
grss_feed_channel_set_update_interval().
gboolean grss_feed_channel_fetch (GrssFeedChannel *channel,GError **error);
Utility to fetch and populate a GrssFeedChannel for the first time, and init
all his internal values. Only the source URL has to be set in channel
(with grss_feed_channel_set_source()). Be aware this function is sync, do not
returns until the feed isn't downloaded and parsed.
void grss_feed_channel_fetch_async (GrssFeedChannel *channel,GAsyncReadyCallback callback,gpointer user_data);
Similar to grss_feed_channel_fetch(), but asyncronous.
gboolean grss_feed_channel_fetch_finish (GrssFeedChannel *channel,GAsyncResult *res,GError **error);
Finalizes an asyncronous operation started with
grss_feed_channel_fetch_async().
GList * grss_feed_channel_fetch_all (GrssFeedChannel *channel,GError **error);
Utility to fetch and populate a GrssFeedChannel, and retrieve all its items.
channel |
||
error |
if an error occurred, |
a GList
of GrssFeedItem, to be completely unreferenced and freed when no
longer in use, or NULL if an error occurs.
[element-type GrssFeedItem][transfer full]
void grss_feed_channel_fetch_all_async (GrssFeedChannel *channel,GAsyncReadyCallback callback,gpointer user_data);
Similar to grss_feed_channel_fetch_all(), but asyncronous.
GList * grss_feed_channel_fetch_all_finish (GrssFeedChannel *channel,GAsyncResult *res,GError **error);
Finalizes an asyncronous operation started with
grss_feed_channel_fetch_all_async().
channel |
||
res |
the GAsyncResult passed to the callback. |
|
error |
if an error occurred, |
list of
items fetched from the GrssFeedChannel, or NULL if error
is
set. The list (and contained items) is freed at the end of the
callback.
[element-type GrssFeedItem][transfer none]
gboolean
grss_feed_channel_fetch_cancel (GrssFeedChannel *channel);
If a fetch operation was scheduled with grss_feed_channel_fetch_async() or
grss_feed_channel_fetch_all_async(), cancel it.