/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
/*
* GData Client
* Copyright (C) 2014 Carlos Garnacho <carlosg@gnome.org>
*
* GData Client is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* GData Client is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with GData Client. If not, see <http://www.gnu.org/licenses/>.
*/
/**
* SECTION:gdata-freebase-topic-result
* @short_description: GData Freebase topic result object
* @stability: Stable
* @include: gdata/services/freebase/gdata-freebase-topic-result.h
*
* #GDataFreebaseTopicResult is a subclass of #GDataFreebaseResult that contains all or a subset of the information
* contained in Freebase about the Freebase ID given to the #GDataFreebaseTopicQuery.
*
* For more details of Google Freebase API, see the <ulink type="http" url="https://developers.google.com/freebase/v1/">
* online documentation</ulink>.
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
typedef struct _GDataFreebaseTopicValueArray GDataFreebaseTopicValueArray;
#include <config.h>
#include <glib.h>
#include <glib/gi18n-lib.h>
#include <string.h>
#include "gdata-freebase-topic-result.h"
#include "gdata-download-stream.h"
#include "gdata-private.h"
#include "gdata-types.h"
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
typedef enum {
TYPE_NONE,
TYPE_BOOL,
TYPE_INT,
TYPE_DOUBLE,
TYPE_STRING,
TYPE_DATETIME,
TYPE_COMPOUND,
TYPE_OBJECT,
TYPE_KEY,
TYPE_URI
} TopicValueType;
/* Wraps a compound object, either the main object returned by the result, or a
* complex object within the result values (events are at least composed of
* location and time at least, for example).
*/
struct _GDataFreebaseTopicObject {
gchar *id;
GHashTable *values; /* Hashtable of property->GDataFreebaseTopicValueArray */
volatile gint ref_count;
};
/* Wraps an array of values, single-valued properties will contain an array with a single value here */
struct _GDataFreebaseTopicValueArray {
TopicValueType type;
GPtrArray *values;
guint64 hits; /* Total number of hits, as opposed to values->len */
};
/* Wraps a single value in the topic result, may be either simple (numbers, strings, Freebase IDs...),
* or nested compound types (contained by a GDataFreebaseTopicObject, which is what the value would
* contain in that case).
*/
struct _GDataFreebaseTopicValue {
gchar *property;
gchar *text;
gchar *lang;
gchar *creator;
gint64 timestamp;
GValue value;
volatile gint ref_count;
};
struct _GDataFreebaseTopicResultPrivate {
GDataFreebaseTopicObject *object;
};
static void gdata_freebase_topic_result_finalize (GObject *self);
static gboolean parse_json (GDataParsable *parsable, JsonReader *reader, gpointer user_data, GError **error);
static GDataFreebaseTopicObject *object_new (const gchar *id);
static void value_free (GDataFreebaseTopicValue *object);
static gboolean reader_get_properties (JsonReader *reader, GDataFreebaseTopicObject *object, GError **error);
G_DEFINE_BOXED_TYPE (GDataFreebaseTopicObject, gdata_freebase_topic_object, gdata_freebase_topic_object_ref, gdata_freebase_topic_object_unref)
G_DEFINE_BOXED_TYPE (GDataFreebaseTopicValue, gdata_freebase_topic_value, gdata_freebase_topic_value_ref, gdata_freebase_topic_value_unref)
G_DEFINE_TYPE (GDataFreebaseTopicResult, gdata_freebase_topic_result, GDATA_TYPE_FREEBASE_RESULT)
static void
gdata_freebase_topic_result_class_init (GDataFreebaseTopicResultClass *klass)
{
GDataParsableClass *parsable_class = GDATA_PARSABLE_CLASS (klass);
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
g_type_class_add_private (klass, sizeof (GDataFreebaseTopicResultPrivate));
gobject_class->finalize = gdata_freebase_topic_result_finalize;
parsable_class->parse_json = parse_json;
}
static void
gdata_freebase_topic_result_init (GDataFreebaseTopicResult *self)
{
self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, GDATA_TYPE_FREEBASE_TOPIC_RESULT, GDataFreebaseTopicResultPrivate);
}
static void
gdata_freebase_topic_result_finalize (GObject *self)
{
GDataFreebaseTopicResultPrivate *priv = GDATA_FREEBASE_TOPIC_RESULT (self)->priv;
gdata_freebase_topic_object_unref (priv->object);
G_OBJECT_CLASS (gdata_freebase_topic_result_parent_class)->finalize (self);
}
static GDataFreebaseTopicValueArray *
value_array_new (TopicValueType type, guint64 hits)
{
GDataFreebaseTopicValueArray *array;
array = g_slice_new0 (GDataFreebaseTopicValueArray);
array->values = g_ptr_array_new_with_free_func ((GDestroyNotify) gdata_freebase_topic_value_unref);
array->type = type;
array->hits = hits;
return array;
}
/* Takes ownership on @value */
static void
value_array_add (GDataFreebaseTopicValueArray *array, GDataFreebaseTopicValue *value)
{
g_ptr_array_add (array->values, value);
}
static void
value_array_free (GDataFreebaseTopicValueArray *array)
{
g_ptr_array_unref (array->values);
g_slice_free (GDataFreebaseTopicValueArray, array);
}
static guint64
reader_get_item_count (JsonReader *reader)
{
gint64 count;
json_reader_read_member (reader, "count");
count = json_reader_get_int_value (reader);
json_reader_end_member (reader);
return (guint64) count;
}
static guint
reader_get_value_type (JsonReader *reader, const gchar *property, GError **error)
{
TopicValueType type = TYPE_NONE;
const GError *reader_error;
const gchar *valuestr;
json_reader_read_member (reader, "valuetype");
valuestr = json_reader_get_string_value (reader);
reader_error = json_reader_get_error (reader);
if (reader_error != NULL) {
if (error != NULL && *error == NULL)
*error = g_error_copy (reader_error);
} else {
if (strcmp (valuestr, "key") == 0)
type = TYPE_KEY;
else if (strcmp (valuestr, "uri") == 0)
type = TYPE_URI;
else if (strcmp (valuestr, "compound") == 0)
type = TYPE_COMPOUND;
else if (strcmp (valuestr, "object") == 0)
type = TYPE_OBJECT;
else if (strcmp (valuestr, "float") == 0)
type = TYPE_DOUBLE;
else if (strcmp (valuestr, "string") == 0)
type = TYPE_STRING;
else if (strcmp (valuestr, "int") == 0)
type = TYPE_INT;
else if (strcmp (valuestr, "bool") == 0)
type = TYPE_BOOL;
else if (strcmp (valuestr, "datetime") == 0)
type = TYPE_DATETIME;
else
gdata_parser_error_required_json_content_missing (reader, error);
}
json_reader_end_member (reader);
return type;
}
static void
value_free (GDataFreebaseTopicValue *value)
{
if (G_IS_VALUE (&value->value))
g_value_unset (&value->value);
g_free (value->text);
g_free (value->lang);
g_free (value->creator);
g_free (value->property);
g_slice_free (GDataFreebaseTopicValue, value);
}
/* Parsing functions to create GDataFreebaseTopicValues, and arrays of those */
static gchar *
reader_dup_member_string (JsonReader *reader, const gchar *member, GError **error)
{
const GError *reader_error;
gchar *str;
if (error != NULL && *error != NULL)
return NULL;
json_reader_read_member (reader, member);
str = g_strdup (json_reader_get_string_value (reader));
reader_error = json_reader_get_error (reader);
if (reader_error != NULL) {
g_free (str);
str = NULL;
if (error != NULL)
*error = g_error_copy (reader_error);
}
json_reader_end_member (reader);
return str;
}
static gint64
reader_parse_timestamp (JsonReader *reader, const gchar *member, GError **error)
{
const GError *reader_error;
const gchar *date_str;
gint64 timestamp = -1;
if (error != NULL && *error != NULL)
return -1;
json_reader_read_member (reader, member);
date_str = json_reader_get_string_value (reader);
reader_error = json_reader_get_error (reader);
if (reader_error != NULL) {
if (error != NULL)
*error = g_error_copy (reader_error);
} else if (date_str) {
if (!gdata_parser_int64_from_iso8601 (date_str, ×tamp))
timestamp = -1;
}
json_reader_end_member (reader);
return timestamp;
}
static gboolean
reader_fill_simple_gvalue (JsonReader *reader, TopicValueType type, GValue *value)
{
gboolean retval = TRUE;
gint64 datetime;
json_reader_read_member (reader, "value");
if (json_reader_get_error (reader) != NULL) {
json_reader_end_member (reader);
return FALSE;
}
switch (type) {
case TYPE_BOOL:
case TYPE_INT:
case TYPE_DOUBLE:
case TYPE_STRING:
json_node_get_value (json_reader_get_value (reader), value);
break;
case TYPE_DATETIME:
if (gdata_parser_int64_from_iso8601 (json_reader_get_string_value (reader), &datetime) ||
gdata_parser_int64_from_date (json_reader_get_string_value (reader), &datetime)) {
g_value_init (value, G_TYPE_INT64);
g_value_set_int64 (value, datetime);
} else {
retval = FALSE;
}
break;
case TYPE_NONE:
case TYPE_COMPOUND:
case TYPE_OBJECT:
case TYPE_KEY:
case TYPE_URI:
default:
retval = FALSE;
}
json_reader_end_member (reader);
return retval;
}
static GDataFreebaseTopicObject *
reader_create_object (JsonReader *reader, TopicValueType type)
{
GDataFreebaseTopicObject *object;
if (type != TYPE_OBJECT && type != TYPE_COMPOUND)
return NULL;
json_reader_read_member (reader, "id");
if (json_reader_get_error (reader) != NULL) {
json_reader_end_member (reader);
return NULL;
}
object = object_new (json_reader_get_string_value (reader));
json_reader_end_member (reader);
return object;
}
static gboolean
reader_fill_object_gvalue (JsonReader *reader, TopicValueType type, GValue *value)
{
GDataFreebaseTopicObject *object;
if (type != TYPE_OBJECT)
return FALSE;
object = reader_create_object (reader, type);
if (object != NULL) {
g_value_init (value, GDATA_TYPE_FREEBASE_TOPIC_OBJECT);
g_value_take_boxed (value, object);
}
return (object != NULL);
}
static gboolean
reader_fill_compound_gvalue (JsonReader *reader, TopicValueType type, GValue *value, GError **error)
{
GDataFreebaseTopicObject *object;
if (type != TYPE_COMPOUND)
return FALSE;
object = reader_create_object (reader, type);
if (object == NULL)
return FALSE;
json_reader_read_member (reader, "property");
if (json_reader_get_error (reader) != NULL) {
json_reader_end_member (reader);
gdata_freebase_topic_object_unref (object);
return FALSE;
}
reader_get_properties (reader, object, error);
json_reader_end_member (reader);
g_value_init (value, GDATA_TYPE_FREEBASE_TOPIC_OBJECT);
g_value_take_boxed (value, object);
return TRUE;
}
static GDataFreebaseTopicValue *
reader_create_value (JsonReader *reader, const gchar *property, TopicValueType type, GError **error)
{
GDataFreebaseTopicValue *value;
value = g_slice_new0 (GDataFreebaseTopicValue);
value->ref_count = 1;
value->property = g_strdup (property);
value->text = reader_dup_member_string (reader, "text", error);
value->lang = reader_dup_member_string (reader, "lang", error);
/* Not all parsed nodes are meant to contain creator/timestamp tags,
* do not pass error to those, so parsing continues.
*/
value->creator = reader_dup_member_string (reader, "creator", NULL);
value->timestamp = reader_parse_timestamp (reader, "timestamp", NULL);
if (reader_fill_simple_gvalue (reader, type, &value->value) ||
reader_fill_object_gvalue (reader, type, &value->value) ||
reader_fill_compound_gvalue (reader, type, &value->value, error))
return value;
value_free (value);
return NULL;
}
static GDataFreebaseTopicValueArray *
reader_create_value_array (JsonReader *reader, const gchar *property, GError **error)
{
GDataFreebaseTopicValueArray *array;
GDataFreebaseTopicValue *value;
TopicValueType type;
guint64 count, i;
count = reader_get_item_count (reader);
if (count <= 0)
return NULL;
type = reader_get_value_type (reader, property, error);
if (type == TYPE_NONE || type == TYPE_URI || type == TYPE_KEY)
return NULL;
array = value_array_new (type, count);
json_reader_read_member (reader, "values");
count = json_reader_count_elements (reader);
for (i = 0; i < count; i++) {
json_reader_read_element (reader, i);
value = reader_create_value (reader, property, type, error);
json_reader_end_element (reader);
if (value != NULL)
value_array_add (array, value);
}
json_reader_end_member (reader);
return array;
}
static GDataFreebaseTopicObject *
object_new (const gchar *id)
{
GDataFreebaseTopicObject *object;
object = g_slice_new0 (GDataFreebaseTopicObject);
object->id = g_strdup (id);
object->ref_count = 1;
object->values = g_hash_table_new_full (g_str_hash, g_str_equal,
(GDestroyNotify) g_free,
(GDestroyNotify) value_array_free);
return object;
}
/* Takes ownership on @array */
static void
object_add_value (GDataFreebaseTopicObject *object, const gchar *property, GDataFreebaseTopicValueArray *array)
{
g_return_if_fail (object != NULL);
g_return_if_fail (property != NULL);
g_return_if_fail (array != NULL);
g_hash_table_replace (object->values, g_strdup (property), array);
}
static gboolean
reader_get_properties (JsonReader *reader, GDataFreebaseTopicObject *object, GError **error)
{
GDataFreebaseTopicValueArray *array;
gboolean retval = TRUE;
gint count, i;
count = json_reader_count_members (reader);
for (i = 0; i < count; i++) {
GError *inner_error = NULL;
const gchar *name;
gchar *property;
json_reader_read_element (reader, i);
property = g_strdup (json_reader_get_member_name (reader));
name = property;
/* Reverse properties start with !, display those as
* regular properties, and skip that char
*/
if (name[0] == '!')
name++;
/* All Freebase properties and IDs start with '/' */
if (name[0] != '/')
continue;
/* Parse the value for this property, possibly with nested contents */
array = reader_create_value_array (reader, name, &inner_error);
json_reader_end_element (reader);
if (inner_error != NULL) {
g_propagate_error (error, inner_error);
retval = FALSE;
break;
} else if (array != NULL) {
/* Takes ownership of array */
object_add_value (object, name, array);
}
g_free (property);
}
return retval;
}
static gboolean
parse_json (GDataParsable *parsable, JsonReader *reader, gpointer user_data, GError **error)
{
GDataFreebaseTopicResultPrivate *priv = GDATA_FREEBASE_TOPIC_RESULT (parsable)->priv;
const gchar *member_name;
GDATA_PARSABLE_CLASS (gdata_freebase_topic_result_parent_class)->parse_json (parsable, reader, user_data, error);
member_name = json_reader_get_member_name (reader);
if (member_name == NULL)
return FALSE;
if (strcmp (member_name, "id") == 0) {
/* We only expect one member containing information */
g_assert (priv->object == NULL);
priv->object = object_new (json_reader_get_string_value (reader));
} else if (strcmp (member_name, "property") == 0) {
reader_get_properties (reader, priv->object, error);
} else {
return FALSE;
}
return TRUE;
}
/**
* gdata_freebase_topic_result_new:
*
* Creates a new #GDataFreebaseTopicResult with the given ID and default properties.
*
* Return value: (transfer full): a new #GDataFreebaseTopicResult; unref with g_object_unref()
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
GDataFreebaseTopicResult *
gdata_freebase_topic_result_new (void)
{
return g_object_new (GDATA_TYPE_FREEBASE_TOPIC_RESULT, NULL);
}
/**
* gdata_freebase_topic_result_dup_object:
* @self: a #GDataFreebaseTopicResult
*
* Returns a reference to the root #GDataFreebaseTopicObject containing the
* topic query results.
*
* Returns: (transfer full): A new reference on the result object, unref with
* gdata_freebase_topic_object_unref()
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
GDataFreebaseTopicObject *
gdata_freebase_topic_result_dup_object (GDataFreebaseTopicResult *self)
{
g_return_val_if_fail (GDATA_IS_FREEBASE_TOPIC_RESULT (self), NULL);
return gdata_freebase_topic_object_ref (self->priv->object);
}
/**
* gdata_freebase_topic_object_ref:
* @object: a #GDataFreebaseTopicObject
*
* Creates and returns a new reference on @object.
*
* Returns: (transfer full): @object, with an extra reference.
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
GDataFreebaseTopicObject *
gdata_freebase_topic_object_ref (GDataFreebaseTopicObject *object)
{
g_return_val_if_fail (object != NULL, NULL);
g_atomic_int_inc (&object->ref_count);
return object;
}
/**
* gdata_freebase_topic_object_unref:
* @object: (transfer full): a #GDataFreebaseTopicResult
*
* Removes a reference from @object. If the reference count drops to 0,
* the object is freed.
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
void
gdata_freebase_topic_object_unref (GDataFreebaseTopicObject *object)
{
g_return_if_fail (object != NULL);
if (g_atomic_int_dec_and_test (&object->ref_count)) {
g_hash_table_unref (object->values);
g_free (object->id);
g_slice_free (GDataFreebaseTopicObject, object);
}
}
/**
* gdata_freebase_topic_object_list_properties:
* @object: a #GDataFreebaseTopicObject
*
* Returns the list of Freebase properties described by @object.
*
* Returns: (transfer container) (element-type gchar*): An array of property names, free with g_ptr_array_unref().
*
* Since: 0.15.1
Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
GPtrArray *
gdata_freebase_topic_object_list_properties (const GDataFreebaseTopicObject *object)
{
GPtrArray *properties;
GHashTableIter iter;
gchar *property;
g_return_val_if_fail (object != NULL, NULL);
properties = g_ptr_array_new ();
g_hash_table_iter_init (&iter, object->values);
while (g_hash_table_iter_next (&iter, (gpointer *) &property, NULL))
g_ptr_array_add (properties, property);
return properties;
}
/**
* gdata_freebase_topic_object_get_property_count:
* @object: a #GDataFreebaseTopicObject
* @property: a property name contained in @object
*
* Returns the number of values that @object holds for the given @property. If @object
* contains no information about @property, 0 is returned.
*
* Returns: The number of values contained for @property
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
guint64
gdata_freebase_topic_object_get_property_count (const GDataFreebaseTopicObject *object, const gchar *property)
{
GDataFreebaseTopicValueArray *array;
g_return_val_if_fail (object != NULL, 0);
g_return_val_if_fail (property != NULL, 0);
array = g_hash_table_lookup (object->values, property);
if (array == NULL)
return 0;
return array->values->len;
}
/**
* gdata_freebase_topic_object_get_property_hits:
* @object: a #GDataFreebaseTopicObject
* @property: a property name contained in @object
*
* Returns the total number of hits that the Freebase database stores
* for this object, this number either equals or is greater than
* gdata_freebase_topic_object_get_property_count(), the query limit
* can be controlled through gdata_query_set_max_results() on the topic
* query.
*
* If @object contains no information about @property, 0 is returned.
*
* Returns: the total number of hits for this property
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
guint64
gdata_freebase_topic_object_get_property_hits (const GDataFreebaseTopicObject *object, const gchar *property)
{
GDataFreebaseTopicValueArray *array;
g_return_val_if_fail (object != NULL, 0);
g_return_val_if_fail (property != NULL, 0);
array = g_hash_table_lookup (object->values, property);
if (array == NULL)
return 0;
return array->hits;
}
/**
* gdata_freebase_topic_object_get_property_value:
* @object: a #GDataFreebaseTopicObject
* @property: a property name contained in @object
* @item: item number to retrieve from @property
*
* Gets the value that @object stores for this @property/@item pair, as a generic
* #GDataFreebaseTopicValue. If @object contains no information about @property,
* or @item is outside the [0..gdata_freebase_topic_object_get_property_count() - 1]
* range, %NULL is returned.
*
* Returns: (allow-none) (transfer none): the value for this property/item
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
GDataFreebaseTopicValue *
gdata_freebase_topic_object_get_property_value (const GDataFreebaseTopicObject *object, const gchar *property, gint64 item)
{
GDataFreebaseTopicValueArray *array;
g_return_val_if_fail (object != NULL, NULL);
g_return_val_if_fail (property != NULL, NULL);
array = g_hash_table_lookup (object->values, property);
if (array == NULL)
return NULL;
if (item < 0 || item >= array->values->len)
return NULL;
return g_ptr_array_index (array->values, item);
}
/**
* gdata_freebase_topic_object_get_id:
* @object: a #GDataFreebaseTopicObject
*
* Gets the Freebase ID for this specific object.
*
* Returns: (transfer none): the Freebase ID of this object
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
const gchar *
gdata_freebase_topic_object_get_id (const GDataFreebaseTopicObject *object)
{
g_return_val_if_fail (object != NULL, NULL);
return object->id;
}
/**
* gdata_freebase_topic_value_ref:
* @value: a #GDataFreebaseTopicValue
*
* Creates and returns a new reference on @value.
*
* Returns: (transfer full): @value, with an extra reference.
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
GDataFreebaseTopicValue *
gdata_freebase_topic_value_ref (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, NULL);
g_atomic_int_inc (&value->ref_count);
return value;
}
/**
* gdata_freebase_topic_value_unref:
* @value: (transfer full): a #GDataFreebaseTopicValue
*
* Removes a reference from @value. If the reference count drops to 0,
* the object is freed.
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
void
gdata_freebase_topic_value_unref (GDataFreebaseTopicValue *value)
{
g_return_if_fail (value != NULL);
if (g_atomic_int_dec_and_test (&value->ref_count))
value_free (value);
}
/**
* gdata_freebase_topic_value_get_property:
* @value: a #GDataFreebaseTopicValue
*
* Returns the property name that this value describes
*
* Returns: the property name of @value
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
const gchar *
gdata_freebase_topic_value_get_property (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, NULL);
return value->property;
}
/**
* gdata_freebase_topic_value_get_text:
* @value: a #GDataFreebaseTopicValue
*
* Returns a textual representation of this value, this is either
* the value contained transformed to a string, or a concatenation
* of subvalues for compound types.
*
* Returns: a textual representation of @value
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
const gchar *
gdata_freebase_topic_value_get_text (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, NULL);
return value->text;
}
/**
* gdata_freebase_topic_value_get_language:
* @value: a #GDataFreebaseTopicValue
*
* Returns the language used in the content of @value
*
* Returns: the language @value is written in
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
const gchar *
gdata_freebase_topic_value_get_language (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, NULL);
return value->lang;
}
/**
* gdata_freebase_topic_value_get_creator:
* @value: a #GDataFreebaseTopicValue
*
* Returns the Freebase ID of the user that created this value.
*
* Returns: the creator of this value, as a Freebase ID
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
const gchar *
gdata_freebase_topic_value_get_creator (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, NULL);
return value->creator;
}
/**
* gdata_freebase_topic_value_get_timestamp:
* @value: #GDataFreebaseTopicValue
*
* Returns the time at which this value was created in the Freebase database.
* It's a UNIX timestamp in seconds since the epoch. If @value has no timestamp,
* -1 will be returned.
*
* Returns: The creation time of @value, or -1
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
gint64
gdata_freebase_topic_value_get_timestamp (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, 0);
return value->timestamp;
}
/**
* gdata_freebase_topic_value_get_value_type:
* @value: a #GDataFreebaseTopicValue
*
* Returns the #GType of the real value held in @value.
*
* Returns: the #GType of the contained value
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
GType
gdata_freebase_topic_value_get_value_type (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, G_TYPE_INVALID);
return G_VALUE_TYPE (&value->value);
}
/**
* gdata_freebase_topic_value_copy_value:
* @value: a #GDataFreebaseTopicValue
* @gvalue: (out caller-allocates) (transfer full): an empty #GValue
*
* Copies in @gvalue the value held in @value. the #GValue must be later freed through g_value_unset()
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
void
gdata_freebase_topic_value_copy_value (GDataFreebaseTopicValue *value, GValue *gvalue)
{
g_return_if_fail (value != NULL);
g_value_copy (&value->value, gvalue);
}
/**
* gdata_freebase_topic_value_get_int:
* @value: a #GDataFreebaseTopicValue
*
* Returns a #gint64 value held in @value. It is only valid to call this if the #GType is a %G_TYPE_INT64
*
* Returns: the #gint64 value
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
gint64
gdata_freebase_topic_value_get_int (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, 0);
g_return_val_if_fail (G_VALUE_HOLDS_INT64 (&value->value), 0);
return g_value_get_int64 (&value->value);
}
/**
* gdata_freebase_topic_value_get_double:
* @value: a #GDataFreebaseTopicValue
*
* Returns a #gdouble value held in @value. It is only valid to call this if the #GType is a %G_TYPE_DOUBLE
*
* Returns: the #gdouble value
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
gdouble
gdata_freebase_topic_value_get_double (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, 0);
g_return_val_if_fail (G_VALUE_HOLDS_DOUBLE (&value->value), 0);
return g_value_get_double (&value->value);
}
/**
* gdata_freebase_topic_value_get_string:
* @value: a #GDataFreebaseTopicValue
*
* Returns a string value held in @value. It is only valid to call this if the #GType is a %G_TYPE_STRING
*
* Returns: the string value
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
const gchar *
gdata_freebase_topic_value_get_string (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, NULL);
g_return_val_if_fail (G_VALUE_HOLDS_STRING (&value->value), NULL);
return g_value_get_string (&value->value);
}
/**
* gdata_freebase_topic_value_get_object:
* @value: a #GDataFreebaseTopicValue
*
* Returns a compound/complex object held in @value. It is only valid to call this if the #GType is a
* %GDATA_TYPE_FREEBASE_TOPIC_OBJECT.
*
* Returns: (transfer none): the compound value as a #GDataFreebaseTopicObject
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
const GDataFreebaseTopicObject *
gdata_freebase_topic_value_get_object (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, NULL);
g_return_val_if_fail (G_VALUE_HOLDS (&value->value, GDATA_TYPE_FREEBASE_TOPIC_OBJECT), NULL);
return g_value_get_boxed (&value->value);
}
/**
* gdata_freebase_topic_value_is_image:
* @value: a #GDataFreebaseTopicValue
*
* Returns true if @value holds a freebase image object, on such values it
* will be valid to call gdata_freebase_service_get_image() to get a stream
* to the image itself.
*
* Returns: Whether @value holds a Freebase image object
*
* Since: 0.15.1
* Deprecated: 0.17.7: Google Freebase has been permanently shut down.
*/
gboolean
gdata_freebase_topic_value_is_image (GDataFreebaseTopicValue *value)
{
g_return_val_if_fail (value != NULL, FALSE);
return (strcmp (value->property, "/common/topic/image") == 0);
}
G_GNUC_END_IGNORE_DEPRECATIONS