gdata_link_new ()

GDataLink *
gdata_link_new (const gchar *uri,
                const gchar *relation_type);

Creates a new GDataLink. More information is available in the Atom specification.

uri must be non-NULL and non-empty. relation_type must be NULL or non-empty.

gdata_link_get_uri ()

const gchar *
gdata_link_get_uri (GDataLink *self);

Gets the “uri” property. The return value is guaranteed to be a valid IRI, as specified by the Atom protocol. Common relationship values such as alternate are returned as http://www.iana.org/assignments/relation/alternate.

For more information, see the Atom specification.

Since: 0.4.0

gdata_link_set_uri ()

void
gdata_link_set_uri (GDataLink *self,
                    const gchar *uri);

Sets the “uri” property to uri . uri must be non-NULL and non-empty.

Since: 0.4.0

gdata_link_get_relation_type ()

const gchar *
gdata_link_get_relation_type (GDataLink *self);

Gets the “relation-type” property. If the relation type is non-NULL, it will be non-empty.

Since: 0.4.0

gdata_link_set_relation_type ()

void
gdata_link_set_relation_type (GDataLink *self,
                              const gchar *relation_type);

Sets the “relation-type” property to relation_type . If relation_type is one of the standard Atom relation types, use one of the defined relation type values, instead of a static string. e.g. GDATA_LINK_EDIT or GDATA_LINK_SELF.

Set relation_type to NULL to unset the property in the link.

Since: 0.4.0

gdata_link_get_content_type ()

const gchar *
gdata_link_get_content_type (GDataLink *self);

Gets the “content-type” property. If the content type is non-NULL, it will be non-empty.

Since: 0.4.0

gdata_link_set_content_type ()

void
gdata_link_set_content_type (GDataLink *self,
                             const gchar *content_type);

Sets the “content-type” property to content_type . content_type must be NULL or non-empty.

Set content_type to NULL to unset the property in the link.

Since: 0.4.0

gdata_link_get_language ()

const gchar *
gdata_link_get_language (GDataLink *self);

Gets the “language” property. If the language is non-NULL, it will be non-empty.

Since: 0.4.0

gdata_link_set_language ()

void
gdata_link_set_language (GDataLink *self,
                         const gchar *language);

Sets the “language” property to language . language must be NULL or non-empty.

Set language to NULL to unset the property in the link.

Since: 0.4.0

gdata_link_get_title ()

const gchar *
gdata_link_get_title (GDataLink *self);

Gets the “title” property.

Since: 0.4.0

gdata_link_set_title ()

void
gdata_link_set_title (GDataLink *self,
                      const gchar *title);

Sets the “title” property to title .

Set title to NULL to unset the property in the link.

Since: 0.4.0

gdata_link_get_length ()

gint
gdata_link_get_length (GDataLink *self);

Gets the “length” property.

Since: 0.4.0

gdata_link_set_length ()

void
gdata_link_set_length (GDataLink *self,
                       gint length);

Sets the “length” property to length .

Set length to -1 to unset the property in the link.

Since: 0.4.0

GDATA_LINK_ALTERNATE

#define GDATA_LINK_ALTERNATE "http://www.iana.org/assignments/relation/alternate"

The relation type URI for alternate resources to the current one.

For more information, see the Atom specification.

Since: 0.4.0

GDATA_LINK_BATCH

#define GDATA_LINK_BATCH "http://schemas.google.com/g/2005#batch"

The relation type URI for the batch operation URI for a given GDataFeed.

For more information, see the GData specification.

Since: 0.7.0

GDATA_LINK_EDIT

#define GDATA_LINK_EDIT "http://www.iana.org/assignments/relation/edit"

The relation type URI of the edit location for this resource.

For more information, see the Atom Publishing Protocol specification.

Since: 0.4.0

GDATA_LINK_EDIT_MEDIA

#define GDATA_LINK_EDIT_MEDIA "http://www.iana.org/assignments/relation/edit-media"

The relation type URI of the edit location for media resources attached to this resource.

For more information, see the

Since: 0.4.0

GDATA_LINK_ENCLOSURE

#define GDATA_LINK_ENCLOSURE "http://www.iana.org/assignments/relation/enclosure"

The relation type URI for attached objects which may be large in size.

For more information, see the Atom specification.

Since: 0.4.0

GDATA_LINK_RELATED

#define GDATA_LINK_RELATED "http://www.iana.org/assignments/relation/related"

The relation type URI for resources related to the current one.

For more information, see the Atom specification.

Since: 0.4.0

GDATA_LINK_SELF

#define GDATA_LINK_SELF "http://www.iana.org/assignments/relation/self"

The relation type URI for the current resource.

For more information, see the Atom specification.

Since: 0.4.0

GDATA_LINK_VIA

#define GDATA_LINK_VIA "http://www.iana.org/assignments/relation/via"

The relation type URI for the source document of the current resource.

For more information, see the Atom specification.

Since: 0.4.0

GDATA_LINK_PARENT

#define GDATA_LINK_PARENT "http://schemas.google.com/docs/2007#parent"

The relation type URI of the of the location of the parent resource in a hierarchy of entries.

This is an undocumented GData-specific addition to the Atom specification, and is not included in the GData documentation except in examples and in the

Since: 0.15.1

GDataLink

typedef struct _GDataLink GDataLink;

All the fields in the GDataLink structure are private and should never be accessed directly.

GDataLinkClass

typedef struct {
} GDataLinkClass;

All the fields in the GDataLinkClass structure are private and should never be accessed directly.

Since: 0.4.0

The “content-type” property

  “content-type”             gchar *

An advisory media type: it is a hint about the type of the representation that is expected to be returned when the value of the “uri” property is dereferenced.

For more information, see the

Flags: Read / Write

Default value: NULL

Since: 0.4.0

The “language” property

  “language”                 gchar *

Describes the language of the resource pointed to by the “uri” property.

For more information, see the

Flags: Read / Write

Default value: NULL

Since: 0.4.0

The “length” property

  “length”                   gint

Indicates an advisory length of the linked content in octets. -1 means the length is unspecified.

For more information, see the

Flags: Read / Write

Allowed values: >= -1

Default value: -1

Since: 0.4.0

The “relation-type” property

  “relation-type”            gchar *

The link relation type.

For more information, see the

Flags: Read / Write

Default value: "http://www.iana.org/assignments/relation/alternate"

Since: 0.4.0

The “title” property

  “title”                    gchar *

Conveys human-readable information about the link.

For more information, see the

Flags: Read / Write

Default value: NULL

Since: 0.4.0

The “uri” property

  “uri”                      gchar *

The link's IRI.

For more information, see the

Flags: Read / Write

Default value: NULL

Since: 0.4.0