summaryrefslogtreecommitdiff
path: root/gobject/gvaluetypes.c
diff options
context:
space:
mode:
authorColin Walters <walters@verbum.org>2011-09-22 16:08:35 -0400
committerColin Walters <walters@verbum.org>2011-09-22 20:05:38 -0400
commitf42fe6cdc056b77f74ff6e332389d444c50ae7dc (patch)
treeb0b6d6bb1bd548a748041351a9c58ae1d3f88a9a /gobject/gvaluetypes.c
parent1df8160fa675b225809eed2f86d2489133e5e54d (diff)
downloadglib-f42fe6cdc056b77f74ff6e332389d444c50ae7dc.tar.gz
glib-f42fe6cdc056b77f74ff6e332389d444c50ae7dc.tar.bz2
glib-f42fe6cdc056b77f74ff6e332389d444c50ae7dc.zip
gvalue: Add explicitly signed g_value_get_schar() and g_value_set_schar()
The documentation for G_TYPE_CHAR says: "The type designated by G_TYPE_CHAR is unconditionally an 8-bit signed integer." However the return value for g_value_get_char() was just "char" which in C has an unspecified signedness; on e.g. x86 it's signed (which matches the GType), but on e.g. PowerPC or ARM, it's not. We can't break the old API, so we need to suck it up and add new API. Port most internal users, but keep some tests of the old API too. https://bugzilla.gnome.org/show_bug.cgi?id=659870
Diffstat (limited to 'gobject/gvaluetypes.c')
-rw-r--r--gobject/gvaluetypes.c42
1 files changed, 41 insertions, 1 deletions
diff --git a/gobject/gvaluetypes.c b/gobject/gvaluetypes.c
index a05ccd90b..c2850d13a 100644
--- a/gobject/gvaluetypes.c
+++ b/gobject/gvaluetypes.c
@@ -636,6 +636,7 @@ _g_value_types_init (void)
* @v_char: character value to be set
*
* Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
+ * Deprecated: 2.32: This function's input type is broken, see g_value_set_schar()
*/
void
g_value_set_char (GValue *value,
@@ -650,9 +651,13 @@ g_value_set_char (GValue *value,
* g_value_get_char:
* @value: a valid #GValue of type %G_TYPE_CHAR
*
- * Get the contents of a %G_TYPE_CHAR #GValue.
+ * Do not use this function; it is broken on platforms where the %char
+ * type is unsigned, such as ARM and PowerPC. See g_value_get_schar().
+ *
+ * Get the contents of a %G_TYPE_CHAR #GValue.
*
* Returns: character contents of @value
+ * Deprecated: 2.32: This function's return type is broken, see g_value_get_schar()
*/
gchar
g_value_get_char (const GValue *value)
@@ -663,6 +668,41 @@ g_value_get_char (const GValue *value)
}
/**
+ * g_value_set_schar:
+ * @value: a valid #GValue of type %G_TYPE_CHAR
+ * @v_char: signed 8 bit integer to be set
+ *
+ * Set the contents of a %G_TYPE_CHAR #GValue to @v_char.
+ *
+ * Since: 2.32
+ */
+void
+g_value_set_schar (GValue *value,
+ gint8 v_char)
+{
+ g_return_if_fail (G_VALUE_HOLDS_CHAR (value));
+
+ value->data[0].v_int = v_char;
+}
+
+/**
+ * g_value_get_schar:
+ * @value: a valid #GValue of type %G_TYPE_CHAR
+ *
+ * Get the contents of a %G_TYPE_CHAR #GValue.
+ *
+ * Returns: signed 8 bit integer contents of @value
+ * Since: 2.32
+ */
+gint8
+g_value_get_schar (const GValue *value)
+{
+ g_return_val_if_fail (G_VALUE_HOLDS_CHAR (value), 0);
+
+ return value->data[0].v_int;
+}
+
+/**
* g_value_set_uchar:
* @value: a valid #GValue of type %G_TYPE_UCHAR
* @v_uchar: unsigned character value to be set