/* -*- 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, &timestamp))

			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