<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN'
                      'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd' [

<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="gobject-Standard-Parameter-and-Value-Types">
<refmeta>
<refentrytitle role="top_of_page" id="gobject-Standard-Parameter-and-Value-Types.top_of_page">Parameters and Values</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GOBJECT Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Parameters and Values</refname>
<refpurpose>Standard Parameter and Value Types</refpurpose>
</refnamediv>

<refsect1 id="gobject-Standard-Parameter-and-Value-Types.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-BOOLEAN:CAPS">G_IS_PARAM_SPEC_BOOLEAN</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-BOOLEAN:CAPS">G_PARAM_SPEC_BOOLEAN</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-BOOLEAN:CAPS">G_VALUE_HOLDS_BOOLEAN</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-boolean">g_param_spec_boolean</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-boolean">g_value_set_boolean</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-boolean">g_value_get_boolean</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-CHAR:CAPS">G_IS_PARAM_SPEC_CHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-CHAR:CAPS">G_PARAM_SPEC_CHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-CHAR:CAPS">G_VALUE_HOLDS_CHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-char">g_param_spec_char</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-char">g_value_set_char</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-char">g_value_get_char</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint8"><returnvalue>gint8</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-schar">g_value_get_schar</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-schar">g_value_set_schar</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-UCHAR:CAPS">G_IS_PARAM_SPEC_UCHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-UCHAR:CAPS">G_PARAM_SPEC_UCHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-UCHAR:CAPS">G_VALUE_HOLDS_UCHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-uchar">g_param_spec_uchar</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-uchar">g_value_set_uchar</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guchar"><returnvalue>guchar</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-uchar">g_value_get_uchar</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-INT:CAPS">G_IS_PARAM_SPEC_INT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-INT:CAPS">G_PARAM_SPEC_INT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-INT:CAPS">G_VALUE_HOLDS_INT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-int">g_param_spec_int</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-int">g_value_set_int</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-int">g_value_get_int</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-UINT:CAPS">G_IS_PARAM_SPEC_UINT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-UINT:CAPS">G_PARAM_SPEC_UINT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-UINT:CAPS">G_VALUE_HOLDS_UINT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-uint">g_param_spec_uint</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-uint">g_value_set_uint</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint"><returnvalue>guint</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-uint">g_value_get_uint</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-LONG:CAPS">G_IS_PARAM_SPEC_LONG</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-LONG:CAPS">G_PARAM_SPEC_LONG</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-LONG:CAPS">G_VALUE_HOLDS_LONG</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-long">g_param_spec_long</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-long">g_value_set_long</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="glong"><returnvalue>glong</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-long">g_value_get_long</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-ULONG:CAPS">G_IS_PARAM_SPEC_ULONG</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-ULONG:CAPS">G_PARAM_SPEC_ULONG</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-ULONG:CAPS">G_VALUE_HOLDS_ULONG</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-ulong">g_param_spec_ulong</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-ulong">g_value_set_ulong</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gulong"><returnvalue>gulong</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-ulong">g_value_get_ulong</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-INT64:CAPS">G_IS_PARAM_SPEC_INT64</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-INT64:CAPS">G_PARAM_SPEC_INT64</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-INT64:CAPS">G_VALUE_HOLDS_INT64</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-int64">g_param_spec_int64</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-int64">g_value_set_int64</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint64"><returnvalue>gint64</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-int64">g_value_get_int64</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-UINT64:CAPS">G_IS_PARAM_SPEC_UINT64</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-UINT64:CAPS">G_PARAM_SPEC_UINT64</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-UINT64:CAPS">G_VALUE_HOLDS_UINT64</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-uint64">g_param_spec_uint64</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-uint64">g_value_set_uint64</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint64"><returnvalue>guint64</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-uint64">g_value_get_uint64</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-FLOAT:CAPS">G_IS_PARAM_SPEC_FLOAT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-FLOAT:CAPS">G_PARAM_SPEC_FLOAT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-FLOAT:CAPS">G_VALUE_HOLDS_FLOAT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-float">g_param_spec_float</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-float">g_value_set_float</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gfloat"><returnvalue>gfloat</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-float">g_value_get_float</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-DOUBLE:CAPS">G_IS_PARAM_SPEC_DOUBLE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-DOUBLE:CAPS">G_PARAM_SPEC_DOUBLE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-DOUBLE:CAPS">G_VALUE_HOLDS_DOUBLE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-double">g_param_spec_double</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-double">g_value_set_double</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-double">g_value_get_double</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-ENUM:CAPS">G_IS_PARAM_SPEC_ENUM</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-ENUM:CAPS">G_PARAM_SPEC_ENUM</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-ENUM:CAPS">G_VALUE_HOLDS_ENUM</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-enum">g_param_spec_enum</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-enum">g_value_set_enum</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-enum">g_value_get_enum</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-FLAGS:CAPS">G_IS_PARAM_SPEC_FLAGS</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-FLAGS:CAPS">G_PARAM_SPEC_FLAGS</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-FLAGS:CAPS">G_VALUE_HOLDS_FLAGS</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-flags">g_param_spec_flags</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-flags">g_value_set_flags</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="guint"><returnvalue>guint</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-flags">g_value_get_flags</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-STRING:CAPS">G_IS_PARAM_SPEC_STRING</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-STRING:CAPS">G_PARAM_SPEC_STRING</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-STRING:CAPS">G_VALUE_HOLDS_STRING</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-IS-INTERNED-STRING:CAPS">G_VALUE_IS_INTERNED_STRING</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-string">g_param_spec_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-string">g_value_set_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-static-string">g_value_set_static_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-take-string">g_value_take_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-string-take-ownership">g_value_set_string_take_ownership</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-value-get-string">g_value_get_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-value-dup-string">g_value_dup_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-interned-string">g_value_set_interned_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-PARAM:CAPS">G_IS_PARAM_SPEC_PARAM</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-PARAM:CAPS">G_PARAM_SPEC_PARAM</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-PARAM:CAPS">G_VALUE_HOLDS_PARAM</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-param">g_param_spec_param</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-param">g_value_set_param</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-take-param">g_value_take_param</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-param-take-ownership">g_value_set_param_take_ownership</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-value-get-param">g_value_get_param</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-value-dup-param">g_value_dup_param</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-BOXED:CAPS">G_IS_PARAM_SPEC_BOXED</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-BOXED:CAPS">G_PARAM_SPEC_BOXED</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-BOXED:CAPS">G_VALUE_HOLDS_BOXED</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-boxed">g_param_spec_boxed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-boxed">g_value_set_boxed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-static-boxed">g_value_set_static_boxed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-take-boxed">g_value_take_boxed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-boxed-take-ownership">g_value_set_boxed_take_ownership</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-boxed">g_value_get_boxed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-dup-boxed">g_value_dup_boxed</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-POINTER:CAPS">G_IS_PARAM_SPEC_POINTER</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-POINTER:CAPS">G_PARAM_SPEC_POINTER</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-POINTER:CAPS">G_VALUE_HOLDS_POINTER</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-pointer">g_param_spec_pointer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-pointer">g_value_set_pointer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-pointer">g_value_get_pointer</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-OBJECT:CAPS">G_IS_PARAM_SPEC_OBJECT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-OBJECT:CAPS">G_PARAM_SPEC_OBJECT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-OBJECT:CAPS">G_VALUE_HOLDS_OBJECT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-object">g_param_spec_object</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-object">g_value_set_object</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-take-object">g_value_take_object</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-object-take-ownership">g_value_set_object_take_ownership</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-object">g_value_get_object</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-dup-object">g_value_dup_object</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-UNICHAR:CAPS">G_IS_PARAM_SPEC_UNICHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-UNICHAR:CAPS">G_PARAM_SPEC_UNICHAR</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-unichar">g_param_spec_unichar</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-VALUE-ARRAY:CAPS">G_IS_PARAM_SPEC_VALUE_ARRAY</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-VALUE-ARRAY:CAPS">G_PARAM_SPEC_VALUE_ARRAY</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-value-array">g_param_spec_value_array</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-OVERRIDE:CAPS">G_IS_PARAM_SPEC_OVERRIDE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-OVERRIDE:CAPS">G_PARAM_SPEC_OVERRIDE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-override">g_param_spec_override</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-GTYPE:CAPS">G_IS_PARAM_SPEC_GTYPE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-GTYPE:CAPS">G_PARAM_SPEC_GTYPE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-GTYPE:CAPS">G_VALUE_HOLDS_GTYPE</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-gtype">g_param_spec_gtype</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GType"><returnvalue>GType</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-get-gtype">g_value_get_gtype</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-gtype">g_value_set_gtype</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-IS-PARAM-SPEC-VARIANT:CAPS">G_IS_PARAM_SPEC_VARIANT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-PARAM-SPEC-VARIANT:CAPS">G_PARAM_SPEC_VARIANT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-HOLDS-VARIANT:CAPS">G_VALUE_HOLDS_VARIANT</link><phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-param-spec-variant">g_param_spec_variant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-value-get-variant">g_value_get_variant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="g-value-dup-variant">g_value_dup_variant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-set-variant">g_value_set_variant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="g-value-take-variant">g_value_take_variant</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="gobject-Standard-Parameter-and-Value-Types.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-BOOLEAN:CAPS">G_TYPE_PARAM_BOOLEAN</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecBoolean">GParamSpecBoolean</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-CHAR:CAPS">G_TYPE_PARAM_CHAR</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecChar">GParamSpecChar</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-UCHAR:CAPS">G_TYPE_PARAM_UCHAR</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecUChar">GParamSpecUChar</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-INT:CAPS">G_TYPE_PARAM_INT</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecInt">GParamSpecInt</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-UINT:CAPS">G_TYPE_PARAM_UINT</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecUInt">GParamSpecUInt</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-LONG:CAPS">G_TYPE_PARAM_LONG</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecLong">GParamSpecLong</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-ULONG:CAPS">G_TYPE_PARAM_ULONG</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecULong">GParamSpecULong</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-INT64:CAPS">G_TYPE_PARAM_INT64</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecInt64">GParamSpecInt64</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-UINT64:CAPS">G_TYPE_PARAM_UINT64</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecUInt64">GParamSpecUInt64</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-FLOAT:CAPS">G_TYPE_PARAM_FLOAT</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecFloat">GParamSpecFloat</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-DOUBLE:CAPS">G_TYPE_PARAM_DOUBLE</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecDouble">GParamSpecDouble</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-ENUM:CAPS">G_TYPE_PARAM_ENUM</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecEnum">GParamSpecEnum</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-FLAGS:CAPS">G_TYPE_PARAM_FLAGS</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecFlags">GParamSpecFlags</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-STRING:CAPS">G_TYPE_PARAM_STRING</link></entry></row>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-VALUE-INTERNED-STRING:CAPS">G_VALUE_INTERNED_STRING</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecString">GParamSpecString</link></entry></row>
<row><entry role="typedef_keyword">typedef</entry><entry role="function_name"><link linkend="gchararray">gchararray</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-PARAM:CAPS">G_TYPE_PARAM_PARAM</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecParam">GParamSpecParam</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-BOXED:CAPS">G_TYPE_PARAM_BOXED</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecBoxed">GParamSpecBoxed</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-POINTER:CAPS">G_TYPE_PARAM_POINTER</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecPointer">GParamSpecPointer</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-OBJECT:CAPS">G_TYPE_PARAM_OBJECT</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecObject">GParamSpecObject</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-UNICHAR:CAPS">G_TYPE_PARAM_UNICHAR</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecUnichar">GParamSpecUnichar</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-VALUE-ARRAY:CAPS">G_TYPE_PARAM_VALUE_ARRAY</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecValueArray">GParamSpecValueArray</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-OVERRIDE:CAPS">G_TYPE_PARAM_OVERRIDE</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecOverride">GParamSpecOverride</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-GTYPE:CAPS">G_TYPE_PARAM_GTYPE</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecGType">GParamSpecGType</link></entry></row>

<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="G-TYPE-PARAM-VARIANT:CAPS">G_TYPE_PARAM_VARIANT</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="GParamSpecVariant">GParamSpecVariant</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 id="gobject-Standard-Parameter-and-Value-Types.includes"><title>Includes</title><synopsis>#include &lt;glib-object.h&gt;
</synopsis></refsect1>

<refsect1 id="gobject-Standard-Parameter-and-Value-Types.description" role="desc">
<title role="desc.title">Description</title>
<para><link linkend="GValue"><type>GValue</type></link> provides an abstract container structure which can be
copied, transformed and compared while holding a value of any
(derived) type, which is registered as a <link linkend="GType"><type>GType</type></link> with a
<link linkend="GTypeValueTable"><type>GTypeValueTable</type></link> in its <link linkend="GTypeInfo"><type>GTypeInfo</type></link> structure.  Parameter
specifications for most value types can be created as <link linkend="GParamSpec"><type>GParamSpec</type></link>
derived instances, to implement e.g. <link linkend="GObject"><type>GObject</type></link> properties which
operate on <link linkend="GValue"><type>GValue</type></link> containers.</para>
<para>Parameter names need to start with a letter (a-z or A-Z). Subsequent
characters can be letters, numbers or a '-'.
All other characters are replaced by a '-' during construction.</para>

</refsect1>
<refsect1 id="gobject-Standard-Parameter-and-Value-Types.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="G-IS-PARAM-SPEC-BOOLEAN:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_BOOLEAN()</title>
<indexterm zone="G-IS-PARAM-SPEC-BOOLEAN:CAPS"><primary sortas="IS_PARAM_SPEC_BOOLEAN">G_IS_PARAM_SPEC_BOOLEAN</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_BOOLEAN(pspec)     (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOOLEAN))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-BOOLEAN:CAPS"><literal>G_TYPE_PARAM_BOOLEAN</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-BOOLEAN.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-BOOLEAN.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-BOOLEAN:CAPS" role="macro">
<title>G_PARAM_SPEC_BOOLEAN()</title>
<indexterm zone="G-PARAM-SPEC-BOOLEAN:CAPS"><primary sortas="PARAM_SPEC_BOOLEAN">G_PARAM_SPEC_BOOLEAN</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_BOOLEAN(pspec)        (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOOLEAN, GParamSpecBoolean))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecBoolean"><type>GParamSpecBoolean</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-BOOLEAN.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-BOOLEAN:CAPS" role="macro">
<title>G_VALUE_HOLDS_BOOLEAN()</title>
<indexterm zone="G-VALUE-HOLDS-BOOLEAN:CAPS"><primary sortas="VALUE_HOLDS_BOOLEAN">G_VALUE_HOLDS_BOOLEAN</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_BOOLEAN(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOOLEAN))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-BOOLEAN:CAPS"><literal>G_TYPE_BOOLEAN</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-BOOLEAN.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-BOOLEAN.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-boolean" role="function">
<title>g_param_spec_boolean&#160;()</title>
<indexterm zone="g-param-spec-boolean"><primary sortas="param_spec_boolean">g_param_spec_boolean</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_boolean (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                      <parameter><link linkend="gboolean"><type>gboolean</type></link> default_value</parameter>,
                      <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecBoolean"><type>GParamSpecBoolean</type></link> instance specifying a <link linkend="G-TYPE-BOOLEAN:CAPS"><literal>G_TYPE_BOOLEAN</literal></link>
property. In many cases, it may be more appropriate to use an enum with
<link linkend="g-param-spec-enum"><function>g_param_spec_enum()</function></link>, both to improve code clarity by using explicitly named
values, and to allow for more values to be added in future without breaking
API.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-boolean.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-boolean.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-boolean" role="function">
<title>g_value_set_boolean&#160;()</title>
<indexterm zone="g-value-set-boolean"><primary sortas="value_set_boolean">g_value_set_boolean</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_boolean (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                     <parameter><link linkend="gboolean"><type>gboolean</type></link> v_boolean</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-BOOLEAN:CAPS"><literal>G_TYPE_BOOLEAN</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_boolean</parameter>
.</para>
<refsect3 id="g-value-set-boolean.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-BOOLEAN:CAPS"><literal>G_TYPE_BOOLEAN</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_boolean</para></entry>
<entry role="parameter_description"><para>boolean value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-boolean" role="function">
<title>g_value_get_boolean&#160;()</title>
<indexterm zone="g-value-get-boolean"><primary sortas="value_get_boolean">g_value_get_boolean</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
g_value_get_boolean (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-BOOLEAN:CAPS"><literal>G_TYPE_BOOLEAN</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-boolean.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-BOOLEAN:CAPS"><literal>G_TYPE_BOOLEAN</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-boolean.returns" role="returns">
<title>Returns</title>
<para> boolean contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-CHAR:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_CHAR()</title>
<indexterm zone="G-IS-PARAM-SPEC-CHAR:CAPS"><primary sortas="IS_PARAM_SPEC_CHAR">G_IS_PARAM_SPEC_CHAR</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_CHAR(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_CHAR))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-CHAR:CAPS"><literal>G_TYPE_PARAM_CHAR</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-CHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-CHAR.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-CHAR:CAPS" role="macro">
<title>G_PARAM_SPEC_CHAR()</title>
<indexterm zone="G-PARAM-SPEC-CHAR:CAPS"><primary sortas="PARAM_SPEC_CHAR">G_PARAM_SPEC_CHAR</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_CHAR(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_CHAR, GParamSpecChar))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecChar"><type>GParamSpecChar</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-CHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-CHAR:CAPS" role="macro">
<title>G_VALUE_HOLDS_CHAR()</title>
<indexterm zone="G-VALUE-HOLDS-CHAR:CAPS"><primary sortas="VALUE_HOLDS_CHAR">G_VALUE_HOLDS_CHAR</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_CHAR(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_CHAR))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-CHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-CHAR.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-char" role="function">
<title>g_param_spec_char&#160;()</title>
<indexterm zone="g-param-spec-char"><primary sortas="param_spec_char">g_param_spec_char</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_char (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                   <parameter><link linkend="gint8"><type>gint8</type></link> minimum</parameter>,
                   <parameter><link linkend="gint8"><type>gint8</type></link> maximum</parameter>,
                   <parameter><link linkend="gint8"><type>gint8</type></link> default_value</parameter>,
                   <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecChar"><type>GParamSpecChar</type></link> instance specifying a <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link> property.</para>
<refsect3 id="g-param-spec-char.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-char.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-char" role="function" condition="deprecated:2.32: This function's input type is broken, see g_value_set_schar()">
<title>g_value_set_char&#160;()</title>
<indexterm zone="g-value-set-char" role="deprecated"><primary sortas="value_set_char">g_value_set_char</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_char (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                  <parameter><link linkend="gchar"><type>gchar</type></link> v_char</parameter>);</programlisting>
<warning><para><literal>g_value_set_char</literal> has been deprecated since version 2.32 and should not be used in newly-written code.</para> <para>This function's input type is broken, see <link linkend="g-value-set-schar"><function>g_value_set_schar()</function></link></para>
</warning>
<para>Set the contents of a <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_char</parameter>
.</para>
<refsect3 id="g-value-set-char.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_char</para></entry>
<entry role="parameter_description"><para>character value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-char" role="function" condition="deprecated:2.32: This function's return type is broken, see g_value_get_schar()">
<title>g_value_get_char&#160;()</title>
<indexterm zone="g-value-get-char" role="deprecated"><primary sortas="value_get_char">g_value_get_char</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>
g_value_get_char (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<warning><para><literal>g_value_get_char</literal> has been deprecated since version 2.32 and should not be used in newly-written code.</para> <para>This function's return type is broken, see <link linkend="g-value-get-schar"><function>g_value_get_schar()</function></link></para>
</warning>
<para>Do not use this function; it is broken on platforms where the <link linkend="char"><literal>char</literal></link>
type is unsigned, such as ARM and PowerPC.  See <link linkend="g-value-get-schar"><function>g_value_get_schar()</function></link>.</para>
<para>Get the contents of a <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-char.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-char.returns" role="returns">
<title>Returns</title>
<para> character contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="g-value-get-schar" role="function" condition="since:2.32">
<title>g_value_get_schar&#160;()</title>
<indexterm zone="g-value-get-schar" role="2.32"><primary sortas="value_get_schar">g_value_get_schar</primary></indexterm>
<programlisting language="C"><link linkend="gint8"><returnvalue>gint8</returnvalue></link>
g_value_get_schar (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-schar.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-schar.returns" role="returns">
<title>Returns</title>
<para> signed 8 bit integer contents of <parameter>value</parameter>
</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.32">2.32</link></para></refsect2>
<refsect2 id="g-value-set-schar" role="function" condition="since:2.32">
<title>g_value_set_schar&#160;()</title>
<indexterm zone="g-value-set-schar" role="2.32"><primary sortas="value_set_schar">g_value_set_schar</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_schar (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="gint8"><type>gint8</type></link> v_char</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_char</parameter>
.</para>
<refsect3 id="g-value-set-schar.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-CHAR:CAPS"><literal>G_TYPE_CHAR</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_char</para></entry>
<entry role="parameter_description"><para>signed 8 bit integer to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.32">2.32</link></para></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-UCHAR:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_UCHAR()</title>
<indexterm zone="G-IS-PARAM-SPEC-UCHAR:CAPS"><primary sortas="IS_PARAM_SPEC_UCHAR">G_IS_PARAM_SPEC_UCHAR</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_UCHAR(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UCHAR))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-UCHAR:CAPS"><literal>G_TYPE_PARAM_UCHAR</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-UCHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-UCHAR.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-UCHAR:CAPS" role="macro">
<title>G_PARAM_SPEC_UCHAR()</title>
<indexterm zone="G-PARAM-SPEC-UCHAR:CAPS"><primary sortas="PARAM_SPEC_UCHAR">G_PARAM_SPEC_UCHAR</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_UCHAR(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UCHAR, GParamSpecUChar))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecUChar"><type>GParamSpecUChar</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-UCHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-UCHAR:CAPS" role="macro">
<title>G_VALUE_HOLDS_UCHAR()</title>
<indexterm zone="G-VALUE-HOLDS-UCHAR:CAPS"><primary sortas="VALUE_HOLDS_UCHAR">G_VALUE_HOLDS_UCHAR</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_UCHAR(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UCHAR))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-UCHAR:CAPS"><literal>G_TYPE_UCHAR</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-UCHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-UCHAR.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-uchar" role="function">
<title>g_param_spec_uchar&#160;()</title>
<indexterm zone="g-param-spec-uchar"><primary sortas="param_spec_uchar">g_param_spec_uchar</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_uchar (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="guint8"><type>guint8</type></link> minimum</parameter>,
                    <parameter><link linkend="guint8"><type>guint8</type></link> maximum</parameter>,
                    <parameter><link linkend="guint8"><type>guint8</type></link> default_value</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecUChar"><type>GParamSpecUChar</type></link> instance specifying a <link linkend="G-TYPE-UCHAR:CAPS"><literal>G_TYPE_UCHAR</literal></link> property.</para>
<refsect3 id="g-param-spec-uchar.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-uchar.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-uchar" role="function">
<title>g_value_set_uchar&#160;()</title>
<indexterm zone="g-value-set-uchar"><primary sortas="value_set_uchar">g_value_set_uchar</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_uchar (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="guchar"><type>guchar</type></link> v_uchar</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-UCHAR:CAPS"><literal>G_TYPE_UCHAR</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_uchar</parameter>
.</para>
<refsect3 id="g-value-set-uchar.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-UCHAR:CAPS"><literal>G_TYPE_UCHAR</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_uchar</para></entry>
<entry role="parameter_description"><para>unsigned character value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-uchar" role="function">
<title>g_value_get_uchar&#160;()</title>
<indexterm zone="g-value-get-uchar"><primary sortas="value_get_uchar">g_value_get_uchar</primary></indexterm>
<programlisting language="C"><link linkend="guchar"><returnvalue>guchar</returnvalue></link>
g_value_get_uchar (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-UCHAR:CAPS"><literal>G_TYPE_UCHAR</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-uchar.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-UCHAR:CAPS"><literal>G_TYPE_UCHAR</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-uchar.returns" role="returns">
<title>Returns</title>
<para> unsigned character contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-INT:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_INT()</title>
<indexterm zone="G-IS-PARAM-SPEC-INT:CAPS"><primary sortas="IS_PARAM_SPEC_INT">G_IS_PARAM_SPEC_INT</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_INT(pspec)         (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-INT:CAPS"><literal>G_TYPE_PARAM_INT</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-INT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-INT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-INT:CAPS" role="macro">
<title>G_PARAM_SPEC_INT()</title>
<indexterm zone="G-PARAM-SPEC-INT:CAPS"><primary sortas="PARAM_SPEC_INT">G_PARAM_SPEC_INT</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_INT(pspec)            (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT, GParamSpecInt))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecInt"><type>GParamSpecInt</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-INT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-INT:CAPS" role="macro">
<title>G_VALUE_HOLDS_INT()</title>
<indexterm zone="G-VALUE-HOLDS-INT:CAPS"><primary sortas="VALUE_HOLDS_INT">G_VALUE_HOLDS_INT</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_INT(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-INT:CAPS"><literal>G_TYPE_INT</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-INT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-INT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-int" role="function">
<title>g_param_spec_int&#160;()</title>
<indexterm zone="g-param-spec-int"><primary sortas="param_spec_int">g_param_spec_int</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_int (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                  <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                  <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                  <parameter><link linkend="gint"><type>gint</type></link> minimum</parameter>,
                  <parameter><link linkend="gint"><type>gint</type></link> maximum</parameter>,
                  <parameter><link linkend="gint"><type>gint</type></link> default_value</parameter>,
                  <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecInt"><type>GParamSpecInt</type></link> instance specifying a <link linkend="G-TYPE-INT:CAPS"><literal>G_TYPE_INT</literal></link> property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-int.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-int.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-int" role="function">
<title>g_value_set_int&#160;()</title>
<indexterm zone="g-value-set-int"><primary sortas="value_set_int">g_value_set_int</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_int (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                 <parameter><link linkend="gint"><type>gint</type></link> v_int</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-INT:CAPS"><literal>G_TYPE_INT</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_int</parameter>
.</para>
<refsect3 id="g-value-set-int.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-INT:CAPS"><literal>G_TYPE_INT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_int</para></entry>
<entry role="parameter_description"><para>integer value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-int" role="function">
<title>g_value_get_int&#160;()</title>
<indexterm zone="g-value-get-int"><primary sortas="value_get_int">g_value_get_int</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
g_value_get_int (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-INT:CAPS"><literal>G_TYPE_INT</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-int.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-INT:CAPS"><literal>G_TYPE_INT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-int.returns" role="returns">
<title>Returns</title>
<para> integer contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-UINT:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_UINT()</title>
<indexterm zone="G-IS-PARAM-SPEC-UINT:CAPS"><primary sortas="IS_PARAM_SPEC_UINT">G_IS_PARAM_SPEC_UINT</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_UINT(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-UINT:CAPS"><literal>G_TYPE_PARAM_UINT</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-UINT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-UINT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-UINT:CAPS" role="macro">
<title>G_PARAM_SPEC_UINT()</title>
<indexterm zone="G-PARAM-SPEC-UINT:CAPS"><primary sortas="PARAM_SPEC_UINT">G_PARAM_SPEC_UINT</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_UINT(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT, GParamSpecUInt))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecUInt"><type>GParamSpecUInt</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-UINT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-UINT:CAPS" role="macro">
<title>G_VALUE_HOLDS_UINT()</title>
<indexterm zone="G-VALUE-HOLDS-UINT:CAPS"><primary sortas="VALUE_HOLDS_UINT">G_VALUE_HOLDS_UINT</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_UINT(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-UINT:CAPS"><literal>G_TYPE_UINT</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-UINT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-UINT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-uint" role="function">
<title>g_param_spec_uint&#160;()</title>
<indexterm zone="g-param-spec-uint"><primary sortas="param_spec_uint">g_param_spec_uint</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_uint (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                   <parameter><link linkend="guint"><type>guint</type></link> minimum</parameter>,
                   <parameter><link linkend="guint"><type>guint</type></link> maximum</parameter>,
                   <parameter><link linkend="guint"><type>guint</type></link> default_value</parameter>,
                   <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecUInt"><type>GParamSpecUInt</type></link> instance specifying a <link linkend="G-TYPE-UINT:CAPS"><literal>G_TYPE_UINT</literal></link> property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-uint.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-uint.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-uint" role="function">
<title>g_value_set_uint&#160;()</title>
<indexterm zone="g-value-set-uint"><primary sortas="value_set_uint">g_value_set_uint</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_uint (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                  <parameter><link linkend="guint"><type>guint</type></link> v_uint</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-UINT:CAPS"><literal>G_TYPE_UINT</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_uint</parameter>
.</para>
<refsect3 id="g-value-set-uint.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-UINT:CAPS"><literal>G_TYPE_UINT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_uint</para></entry>
<entry role="parameter_description"><para>unsigned integer value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-uint" role="function">
<title>g_value_get_uint&#160;()</title>
<indexterm zone="g-value-get-uint"><primary sortas="value_get_uint">g_value_get_uint</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
g_value_get_uint (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-UINT:CAPS"><literal>G_TYPE_UINT</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-uint.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-UINT:CAPS"><literal>G_TYPE_UINT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-uint.returns" role="returns">
<title>Returns</title>
<para> unsigned integer contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-LONG:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_LONG()</title>
<indexterm zone="G-IS-PARAM-SPEC-LONG:CAPS"><primary sortas="IS_PARAM_SPEC_LONG">G_IS_PARAM_SPEC_LONG</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_LONG(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_LONG))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-LONG:CAPS"><literal>G_TYPE_PARAM_LONG</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-LONG.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-LONG.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-LONG:CAPS" role="macro">
<title>G_PARAM_SPEC_LONG()</title>
<indexterm zone="G-PARAM-SPEC-LONG:CAPS"><primary sortas="PARAM_SPEC_LONG">G_PARAM_SPEC_LONG</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_LONG(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_LONG, GParamSpecLong))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecLong"><type>GParamSpecLong</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-LONG.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-LONG:CAPS" role="macro">
<title>G_VALUE_HOLDS_LONG()</title>
<indexterm zone="G-VALUE-HOLDS-LONG:CAPS"><primary sortas="VALUE_HOLDS_LONG">G_VALUE_HOLDS_LONG</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_LONG(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_LONG))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-LONG:CAPS"><literal>G_TYPE_LONG</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-LONG.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-LONG.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-long" role="function">
<title>g_param_spec_long&#160;()</title>
<indexterm zone="g-param-spec-long"><primary sortas="param_spec_long">g_param_spec_long</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_long (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                   <parameter><link linkend="glong"><type>glong</type></link> minimum</parameter>,
                   <parameter><link linkend="glong"><type>glong</type></link> maximum</parameter>,
                   <parameter><link linkend="glong"><type>glong</type></link> default_value</parameter>,
                   <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecLong"><type>GParamSpecLong</type></link> instance specifying a <link linkend="G-TYPE-LONG:CAPS"><literal>G_TYPE_LONG</literal></link> property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-long.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-long.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-long" role="function">
<title>g_value_set_long&#160;()</title>
<indexterm zone="g-value-set-long"><primary sortas="value_set_long">g_value_set_long</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_long (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                  <parameter><link linkend="glong"><type>glong</type></link> v_long</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-LONG:CAPS"><literal>G_TYPE_LONG</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_long</parameter>
.</para>
<refsect3 id="g-value-set-long.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-LONG:CAPS"><literal>G_TYPE_LONG</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_long</para></entry>
<entry role="parameter_description"><para>long integer value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-long" role="function">
<title>g_value_get_long&#160;()</title>
<indexterm zone="g-value-get-long"><primary sortas="value_get_long">g_value_get_long</primary></indexterm>
<programlisting language="C"><link linkend="glong"><returnvalue>glong</returnvalue></link>
g_value_get_long (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-LONG:CAPS"><literal>G_TYPE_LONG</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-long.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-LONG:CAPS"><literal>G_TYPE_LONG</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-long.returns" role="returns">
<title>Returns</title>
<para> long integer contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-ULONG:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_ULONG()</title>
<indexterm zone="G-IS-PARAM-SPEC-ULONG:CAPS"><primary sortas="IS_PARAM_SPEC_ULONG">G_IS_PARAM_SPEC_ULONG</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_ULONG(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ULONG))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-ULONG:CAPS"><literal>G_TYPE_PARAM_ULONG</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-ULONG.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-ULONG.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-ULONG:CAPS" role="macro">
<title>G_PARAM_SPEC_ULONG()</title>
<indexterm zone="G-PARAM-SPEC-ULONG:CAPS"><primary sortas="PARAM_SPEC_ULONG">G_PARAM_SPEC_ULONG</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_ULONG(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ULONG, GParamSpecULong))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecULong"><type>GParamSpecULong</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-ULONG.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-ULONG:CAPS" role="macro">
<title>G_VALUE_HOLDS_ULONG()</title>
<indexterm zone="G-VALUE-HOLDS-ULONG:CAPS"><primary sortas="VALUE_HOLDS_ULONG">G_VALUE_HOLDS_ULONG</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_ULONG(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ULONG))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-ULONG:CAPS"><literal>G_TYPE_ULONG</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-ULONG.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-ULONG.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-ulong" role="function">
<title>g_param_spec_ulong&#160;()</title>
<indexterm zone="g-param-spec-ulong"><primary sortas="param_spec_ulong">g_param_spec_ulong</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_ulong (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="gulong"><type>gulong</type></link> minimum</parameter>,
                    <parameter><link linkend="gulong"><type>gulong</type></link> maximum</parameter>,
                    <parameter><link linkend="gulong"><type>gulong</type></link> default_value</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecULong"><type>GParamSpecULong</type></link> instance specifying a <link linkend="G-TYPE-ULONG:CAPS"><literal>G_TYPE_ULONG</literal></link>
property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-ulong.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-ulong.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-ulong" role="function">
<title>g_value_set_ulong&#160;()</title>
<indexterm zone="g-value-set-ulong"><primary sortas="value_set_ulong">g_value_set_ulong</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_ulong (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="gulong"><type>gulong</type></link> v_ulong</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-ULONG:CAPS"><literal>G_TYPE_ULONG</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_ulong</parameter>
.</para>
<refsect3 id="g-value-set-ulong.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-ULONG:CAPS"><literal>G_TYPE_ULONG</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_ulong</para></entry>
<entry role="parameter_description"><para>unsigned long integer value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-ulong" role="function">
<title>g_value_get_ulong&#160;()</title>
<indexterm zone="g-value-get-ulong"><primary sortas="value_get_ulong">g_value_get_ulong</primary></indexterm>
<programlisting language="C"><link linkend="gulong"><returnvalue>gulong</returnvalue></link>
g_value_get_ulong (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-ULONG:CAPS"><literal>G_TYPE_ULONG</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-ulong.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-ULONG:CAPS"><literal>G_TYPE_ULONG</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-ulong.returns" role="returns">
<title>Returns</title>
<para> unsigned long integer contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-INT64:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_INT64()</title>
<indexterm zone="G-IS-PARAM-SPEC-INT64:CAPS"><primary sortas="IS_PARAM_SPEC_INT64">G_IS_PARAM_SPEC_INT64</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_INT64(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_INT64))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-INT64:CAPS"><literal>G_TYPE_PARAM_INT64</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-INT64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-INT64.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-INT64:CAPS" role="macro">
<title>G_PARAM_SPEC_INT64()</title>
<indexterm zone="G-PARAM-SPEC-INT64:CAPS"><primary sortas="PARAM_SPEC_INT64">G_PARAM_SPEC_INT64</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_INT64(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_INT64, GParamSpecInt64))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecInt64"><type>GParamSpecInt64</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-INT64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-INT64:CAPS" role="macro">
<title>G_VALUE_HOLDS_INT64()</title>
<indexterm zone="G-VALUE-HOLDS-INT64:CAPS"><primary sortas="VALUE_HOLDS_INT64">G_VALUE_HOLDS_INT64</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_INT64(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_INT64))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-INT64:CAPS"><literal>G_TYPE_INT64</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-INT64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-INT64.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-int64" role="function">
<title>g_param_spec_int64&#160;()</title>
<indexterm zone="g-param-spec-int64"><primary sortas="param_spec_int64">g_param_spec_int64</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_int64 (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="gint64"><type>gint64</type></link> minimum</parameter>,
                    <parameter><link linkend="gint64"><type>gint64</type></link> maximum</parameter>,
                    <parameter><link linkend="gint64"><type>gint64</type></link> default_value</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecInt64"><type>GParamSpecInt64</type></link> instance specifying a <link linkend="G-TYPE-INT64:CAPS"><literal>G_TYPE_INT64</literal></link> property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-int64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-int64.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-int64" role="function">
<title>g_value_set_int64&#160;()</title>
<indexterm zone="g-value-set-int64"><primary sortas="value_set_int64">g_value_set_int64</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_int64 (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="gint64"><type>gint64</type></link> v_int64</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-INT64:CAPS"><literal>G_TYPE_INT64</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_int64</parameter>
.</para>
<refsect3 id="g-value-set-int64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-INT64:CAPS"><literal>G_TYPE_INT64</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_int64</para></entry>
<entry role="parameter_description"><para>64bit integer value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-int64" role="function">
<title>g_value_get_int64&#160;()</title>
<indexterm zone="g-value-get-int64"><primary sortas="value_get_int64">g_value_get_int64</primary></indexterm>
<programlisting language="C"><link linkend="gint64"><returnvalue>gint64</returnvalue></link>
g_value_get_int64 (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-INT64:CAPS"><literal>G_TYPE_INT64</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-int64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-INT64:CAPS"><literal>G_TYPE_INT64</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-int64.returns" role="returns">
<title>Returns</title>
<para> 64bit integer contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-UINT64:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_UINT64()</title>
<indexterm zone="G-IS-PARAM-SPEC-UINT64:CAPS"><primary sortas="IS_PARAM_SPEC_UINT64">G_IS_PARAM_SPEC_UINT64</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_UINT64(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UINT64))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-UINT64:CAPS"><literal>G_TYPE_PARAM_UINT64</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-UINT64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-UINT64.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-UINT64:CAPS" role="macro">
<title>G_PARAM_SPEC_UINT64()</title>
<indexterm zone="G-PARAM-SPEC-UINT64:CAPS"><primary sortas="PARAM_SPEC_UINT64">G_PARAM_SPEC_UINT64</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_UINT64(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UINT64, GParamSpecUInt64))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecUInt64"><type>GParamSpecUInt64</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-UINT64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-UINT64:CAPS" role="macro">
<title>G_VALUE_HOLDS_UINT64()</title>
<indexterm zone="G-VALUE-HOLDS-UINT64:CAPS"><primary sortas="VALUE_HOLDS_UINT64">G_VALUE_HOLDS_UINT64</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_UINT64(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_UINT64))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-UINT64:CAPS"><literal>G_TYPE_UINT64</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-UINT64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-UINT64.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-uint64" role="function">
<title>g_param_spec_uint64&#160;()</title>
<indexterm zone="g-param-spec-uint64"><primary sortas="param_spec_uint64">g_param_spec_uint64</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_uint64 (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                     <parameter><link linkend="guint64"><type>guint64</type></link> minimum</parameter>,
                     <parameter><link linkend="guint64"><type>guint64</type></link> maximum</parameter>,
                     <parameter><link linkend="guint64"><type>guint64</type></link> default_value</parameter>,
                     <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecUInt64"><type>GParamSpecUInt64</type></link> instance specifying a <link linkend="G-TYPE-UINT64:CAPS"><literal>G_TYPE_UINT64</literal></link>
property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-uint64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-uint64.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-uint64" role="function">
<title>g_value_set_uint64&#160;()</title>
<indexterm zone="g-value-set-uint64"><primary sortas="value_set_uint64">g_value_set_uint64</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_uint64 (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                    <parameter><link linkend="guint64"><type>guint64</type></link> v_uint64</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-UINT64:CAPS"><literal>G_TYPE_UINT64</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_uint64</parameter>
.</para>
<refsect3 id="g-value-set-uint64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-UINT64:CAPS"><literal>G_TYPE_UINT64</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_uint64</para></entry>
<entry role="parameter_description"><para>unsigned 64bit integer value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-uint64" role="function">
<title>g_value_get_uint64&#160;()</title>
<indexterm zone="g-value-get-uint64"><primary sortas="value_get_uint64">g_value_get_uint64</primary></indexterm>
<programlisting language="C"><link linkend="guint64"><returnvalue>guint64</returnvalue></link>
g_value_get_uint64 (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-UINT64:CAPS"><literal>G_TYPE_UINT64</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-uint64.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-UINT64:CAPS"><literal>G_TYPE_UINT64</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-uint64.returns" role="returns">
<title>Returns</title>
<para> unsigned 64bit integer contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-FLOAT:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_FLOAT()</title>
<indexterm zone="G-IS-PARAM-SPEC-FLOAT:CAPS"><primary sortas="IS_PARAM_SPEC_FLOAT">G_IS_PARAM_SPEC_FLOAT</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_FLOAT(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLOAT))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-FLOAT:CAPS"><literal>G_TYPE_PARAM_FLOAT</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-FLOAT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-FLOAT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-FLOAT:CAPS" role="macro">
<title>G_PARAM_SPEC_FLOAT()</title>
<indexterm zone="G-PARAM-SPEC-FLOAT:CAPS"><primary sortas="PARAM_SPEC_FLOAT">G_PARAM_SPEC_FLOAT</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_FLOAT(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLOAT, GParamSpecFloat))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecFloat"><type>GParamSpecFloat</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-FLOAT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-FLOAT:CAPS" role="macro">
<title>G_VALUE_HOLDS_FLOAT()</title>
<indexterm zone="G-VALUE-HOLDS-FLOAT:CAPS"><primary sortas="VALUE_HOLDS_FLOAT">G_VALUE_HOLDS_FLOAT</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_FLOAT(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLOAT))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-FLOAT:CAPS"><literal>G_TYPE_FLOAT</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-FLOAT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-FLOAT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-float" role="function">
<title>g_param_spec_float&#160;()</title>
<indexterm zone="g-param-spec-float"><primary sortas="param_spec_float">g_param_spec_float</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_float (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="gfloat"><type>gfloat</type></link> minimum</parameter>,
                    <parameter><link linkend="gfloat"><type>gfloat</type></link> maximum</parameter>,
                    <parameter><link linkend="gfloat"><type>gfloat</type></link> default_value</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecFloat"><type>GParamSpecFloat</type></link> instance specifying a <link linkend="G-TYPE-FLOAT:CAPS"><literal>G_TYPE_FLOAT</literal></link> property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-float.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-float.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-float" role="function">
<title>g_value_set_float&#160;()</title>
<indexterm zone="g-value-set-float"><primary sortas="value_set_float">g_value_set_float</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_float (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="gfloat"><type>gfloat</type></link> v_float</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-FLOAT:CAPS"><literal>G_TYPE_FLOAT</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_float</parameter>
.</para>
<refsect3 id="g-value-set-float.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-FLOAT:CAPS"><literal>G_TYPE_FLOAT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_float</para></entry>
<entry role="parameter_description"><para>float value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-float" role="function">
<title>g_value_get_float&#160;()</title>
<indexterm zone="g-value-get-float"><primary sortas="value_get_float">g_value_get_float</primary></indexterm>
<programlisting language="C"><link linkend="gfloat"><returnvalue>gfloat</returnvalue></link>
g_value_get_float (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-FLOAT:CAPS"><literal>G_TYPE_FLOAT</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-float.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-FLOAT:CAPS"><literal>G_TYPE_FLOAT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-float.returns" role="returns">
<title>Returns</title>
<para> float contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-DOUBLE:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_DOUBLE()</title>
<indexterm zone="G-IS-PARAM-SPEC-DOUBLE:CAPS"><primary sortas="IS_PARAM_SPEC_DOUBLE">G_IS_PARAM_SPEC_DOUBLE</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_DOUBLE(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_DOUBLE))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-DOUBLE:CAPS"><literal>G_TYPE_PARAM_DOUBLE</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-DOUBLE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-DOUBLE.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-DOUBLE:CAPS" role="macro">
<title>G_PARAM_SPEC_DOUBLE()</title>
<indexterm zone="G-PARAM-SPEC-DOUBLE:CAPS"><primary sortas="PARAM_SPEC_DOUBLE">G_PARAM_SPEC_DOUBLE</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_DOUBLE(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_DOUBLE, GParamSpecDouble))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecDouble"><type>GParamSpecDouble</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-DOUBLE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-DOUBLE:CAPS" role="macro">
<title>G_VALUE_HOLDS_DOUBLE()</title>
<indexterm zone="G-VALUE-HOLDS-DOUBLE:CAPS"><primary sortas="VALUE_HOLDS_DOUBLE">G_VALUE_HOLDS_DOUBLE</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_DOUBLE(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_DOUBLE))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-DOUBLE:CAPS"><literal>G_TYPE_DOUBLE</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-DOUBLE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-DOUBLE.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-double" role="function">
<title>g_param_spec_double&#160;()</title>
<indexterm zone="g-param-spec-double"><primary sortas="param_spec_double">g_param_spec_double</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_double (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                     <parameter><link linkend="gdouble"><type>gdouble</type></link> minimum</parameter>,
                     <parameter><link linkend="gdouble"><type>gdouble</type></link> maximum</parameter>,
                     <parameter><link linkend="gdouble"><type>gdouble</type></link> default_value</parameter>,
                     <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecDouble"><type>GParamSpecDouble</type></link> instance specifying a <link linkend="G-TYPE-DOUBLE:CAPS"><literal>G_TYPE_DOUBLE</literal></link>
property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-double.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>minimum</para></entry>
<entry role="parameter_description"><para>minimum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>maximum</para></entry>
<entry role="parameter_description"><para>maximum value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-double.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-double" role="function">
<title>g_value_set_double&#160;()</title>
<indexterm zone="g-value-set-double"><primary sortas="value_set_double">g_value_set_double</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_double (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                    <parameter><link linkend="gdouble"><type>gdouble</type></link> v_double</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-DOUBLE:CAPS"><literal>G_TYPE_DOUBLE</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_double</parameter>
.</para>
<refsect3 id="g-value-set-double.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-DOUBLE:CAPS"><literal>G_TYPE_DOUBLE</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_double</para></entry>
<entry role="parameter_description"><para>double value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-double" role="function">
<title>g_value_get_double&#160;()</title>
<indexterm zone="g-value-get-double"><primary sortas="value_get_double">g_value_get_double</primary></indexterm>
<programlisting language="C"><link linkend="gdouble"><returnvalue>gdouble</returnvalue></link>
g_value_get_double (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-DOUBLE:CAPS"><literal>G_TYPE_DOUBLE</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-double.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-DOUBLE:CAPS"><literal>G_TYPE_DOUBLE</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-double.returns" role="returns">
<title>Returns</title>
<para> double contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-ENUM:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_ENUM()</title>
<indexterm zone="G-IS-PARAM-SPEC-ENUM:CAPS"><primary sortas="IS_PARAM_SPEC_ENUM">G_IS_PARAM_SPEC_ENUM</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_ENUM(pspec)        (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_ENUM))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-ENUM:CAPS"><literal>G_TYPE_PARAM_ENUM</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-ENUM.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-ENUM.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-ENUM:CAPS" role="macro">
<title>G_PARAM_SPEC_ENUM()</title>
<indexterm zone="G-PARAM-SPEC-ENUM:CAPS"><primary sortas="PARAM_SPEC_ENUM">G_PARAM_SPEC_ENUM</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_ENUM(pspec)           (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_ENUM, GParamSpecEnum))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecEnum"><type>GParamSpecEnum</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-ENUM.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-ENUM:CAPS" role="macro">
<title>G_VALUE_HOLDS_ENUM()</title>
<indexterm zone="G-VALUE-HOLDS-ENUM:CAPS"><primary sortas="VALUE_HOLDS_ENUM">G_VALUE_HOLDS_ENUM</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_ENUM(value)      (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_ENUM))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values derived from type <link linkend="G-TYPE-ENUM:CAPS"><literal>G_TYPE_ENUM</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-ENUM.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-ENUM.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-enum" role="function">
<title>g_param_spec_enum&#160;()</title>
<indexterm zone="g-param-spec-enum"><primary sortas="param_spec_enum">g_param_spec_enum</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_enum (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                   <parameter><link linkend="GType"><type>GType</type></link> enum_type</parameter>,
                   <parameter><link linkend="gint"><type>gint</type></link> default_value</parameter>,
                   <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecEnum"><type>GParamSpecEnum</type></link> instance specifying a <link linkend="G-TYPE-ENUM:CAPS"><literal>G_TYPE_ENUM</literal></link>
property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-enum.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>enum_type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GType"><type>GType</type></link> derived from <link linkend="G-TYPE-ENUM:CAPS"><literal>G_TYPE_ENUM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-enum.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-enum" role="function">
<title>g_value_set_enum&#160;()</title>
<indexterm zone="g-value-set-enum"><primary sortas="value_set_enum">g_value_set_enum</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_enum (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                  <parameter><link linkend="gint"><type>gint</type></link> v_enum</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-ENUM:CAPS"><literal>G_TYPE_ENUM</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_enum</parameter>
.</para>
<refsect3 id="g-value-set-enum.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> whose type is derived from <link linkend="G-TYPE-ENUM:CAPS"><literal>G_TYPE_ENUM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_enum</para></entry>
<entry role="parameter_description"><para>enum value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-enum" role="function">
<title>g_value_get_enum&#160;()</title>
<indexterm zone="g-value-get-enum"><primary sortas="value_get_enum">g_value_get_enum</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
g_value_get_enum (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-ENUM:CAPS"><literal>G_TYPE_ENUM</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-enum.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> whose type is derived from <link linkend="G-TYPE-ENUM:CAPS"><literal>G_TYPE_ENUM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-enum.returns" role="returns">
<title>Returns</title>
<para> enum contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-FLAGS:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_FLAGS()</title>
<indexterm zone="G-IS-PARAM-SPEC-FLAGS:CAPS"><primary sortas="IS_PARAM_SPEC_FLAGS">G_IS_PARAM_SPEC_FLAGS</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_FLAGS(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_FLAGS))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-FLAGS:CAPS"><literal>G_TYPE_PARAM_FLAGS</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-FLAGS.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-FLAGS.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-FLAGS:CAPS" role="macro">
<title>G_PARAM_SPEC_FLAGS()</title>
<indexterm zone="G-PARAM-SPEC-FLAGS:CAPS"><primary sortas="PARAM_SPEC_FLAGS">G_PARAM_SPEC_FLAGS</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_FLAGS(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_FLAGS, GParamSpecFlags))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecFlags"><type>GParamSpecFlags</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-FLAGS.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-FLAGS:CAPS" role="macro">
<title>G_VALUE_HOLDS_FLAGS()</title>
<indexterm zone="G-VALUE-HOLDS-FLAGS:CAPS"><primary sortas="VALUE_HOLDS_FLAGS">G_VALUE_HOLDS_FLAGS</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_FLAGS(value)     (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_FLAGS))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values derived from type <link linkend="G-TYPE-FLAGS:CAPS"><literal>G_TYPE_FLAGS</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-FLAGS.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-FLAGS.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-flags" role="function">
<title>g_param_spec_flags&#160;()</title>
<indexterm zone="g-param-spec-flags"><primary sortas="param_spec_flags">g_param_spec_flags</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_flags (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="GType"><type>GType</type></link> flags_type</parameter>,
                    <parameter><link linkend="guint"><type>guint</type></link> default_value</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecFlags"><type>GParamSpecFlags</type></link> instance specifying a <link linkend="G-TYPE-FLAGS:CAPS"><literal>G_TYPE_FLAGS</literal></link>
property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-flags.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags_type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GType"><type>GType</type></link> derived from <link linkend="G-TYPE-FLAGS:CAPS"><literal>G_TYPE_FLAGS</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-flags.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-flags" role="function">
<title>g_value_set_flags&#160;()</title>
<indexterm zone="g-value-set-flags"><primary sortas="value_set_flags">g_value_set_flags</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_flags (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="guint"><type>guint</type></link> v_flags</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-FLAGS:CAPS"><literal>G_TYPE_FLAGS</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_flags</parameter>
.</para>
<refsect3 id="g-value-set-flags.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> whose type is derived from <link linkend="G-TYPE-FLAGS:CAPS"><literal>G_TYPE_FLAGS</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_flags</para></entry>
<entry role="parameter_description"><para>flags value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-flags" role="function">
<title>g_value_get_flags&#160;()</title>
<indexterm zone="g-value-get-flags"><primary sortas="value_get_flags">g_value_get_flags</primary></indexterm>
<programlisting language="C"><link linkend="guint"><returnvalue>guint</returnvalue></link>
g_value_get_flags (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-FLAGS:CAPS"><literal>G_TYPE_FLAGS</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-flags.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> whose type is derived from <link linkend="G-TYPE-FLAGS:CAPS"><literal>G_TYPE_FLAGS</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-flags.returns" role="returns">
<title>Returns</title>
<para> flags contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-STRING:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_STRING()</title>
<indexterm zone="G-IS-PARAM-SPEC-STRING:CAPS"><primary sortas="IS_PARAM_SPEC_STRING">G_IS_PARAM_SPEC_STRING</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_STRING(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_STRING))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-STRING:CAPS"><literal>G_TYPE_PARAM_STRING</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-STRING.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-STRING.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-STRING:CAPS" role="macro">
<title>G_PARAM_SPEC_STRING()</title>
<indexterm zone="G-PARAM-SPEC-STRING:CAPS"><primary sortas="PARAM_SPEC_STRING">G_PARAM_SPEC_STRING</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_STRING(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_STRING, GParamSpecString))
</programlisting>
<para>Casts a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecString"><type>GParamSpecString</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-STRING.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-STRING:CAPS" role="macro">
<title>G_VALUE_HOLDS_STRING()</title>
<indexterm zone="G-VALUE-HOLDS-STRING:CAPS"><primary sortas="VALUE_HOLDS_STRING">G_VALUE_HOLDS_STRING</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_STRING(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_STRING))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-STRING.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-STRING.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-VALUE-IS-INTERNED-STRING:CAPS" role="macro" condition="since:2.66">
<title>G_VALUE_IS_INTERNED_STRING()</title>
<indexterm zone="G-VALUE-IS-INTERNED-STRING:CAPS" role="2.66"><primary sortas="VALUE_IS_INTERNED_STRING">G_VALUE_IS_INTERNED_STRING</primary></indexterm>
<programlisting language="C">#define G_VALUE_IS_INTERNED_STRING(value) (G_VALUE_HOLDS_STRING (value) &amp;&amp; ((value)-&gt;data[1].v_uint &amp; G_VALUE_INTERNED_STRING)) GLIB_AVAILABLE_MACRO_IN_2_66
</programlisting>
<para>Checks whether <parameter>value</parameter>
 contains a string which is canonical.</para>
<refsect3 id="G-VALUE-IS-INTERNED-STRING.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-IS-INTERNED-STRING.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the value contains a string in its canonical
representation, as returned by <link linkend="g-intern-string"><function>g_intern_string()</function></link>. See also
<link linkend="g-value-set-interned-string"><function>g_value_set_interned_string()</function></link>.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="g-param-spec-string" role="function">
<title>g_param_spec_string&#160;()</title>
<indexterm zone="g-param-spec-string"><primary sortas="param_spec_string">g_param_spec_string</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_string (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *default_value</parameter>,
                     <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecString"><type>GParamSpecString</type></link> instance.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-string.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-string" role="function">
<title>g_value_set_string&#160;()</title>
<indexterm zone="g-value-set-string"><primary sortas="value_set_string">g_value_set_string</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_string (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *v_string</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_string</parameter>
.</para>
<refsect3 id="g-value-set-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_string</para></entry>
<entry role="parameter_description"><para>caller-owned string to be duplicated for the <link linkend="GValue"><type>GValue</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-set-static-string" role="function">
<title>g_value_set_static_string&#160;()</title>
<indexterm zone="g-value-set-static-string"><primary sortas="value_set_static_string">g_value_set_static_string</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_static_string (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *v_string</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_string</parameter>
.
The string is assumed to be static, and is thus not duplicated
when setting the <link linkend="GValue"><type>GValue</type></link>.</para>
<para>If the the string is a canonical string, using <link linkend="g-value-set-interned-string"><function>g_value_set_interned_string()</function></link>
is more appropriate.</para>
<refsect3 id="g-value-set-static-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_string</para></entry>
<entry role="parameter_description"><para>static string to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-take-string" role="function" condition="since:2.4">
<title>g_value_take_string&#160;()</title>
<indexterm zone="g-value-take-string" role="2.4"><primary sortas="value_take_string">g_value_take_string</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_take_string (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                     <parameter><link linkend="gchar"><type>gchar</type></link> *v_string</parameter>);</programlisting>
<para>Sets the contents of a <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_string</parameter>
.</para>
<refsect3 id="g-value-take-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_string</para></entry>
<entry role="parameter_description"><para>string to take ownership of. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="g-value-set-string-take-ownership" role="function" condition="deprecated:2.4: Use g_value_take_string() instead.">
<title>g_value_set_string_take_ownership&#160;()</title>
<indexterm zone="g-value-set-string-take-ownership" role="deprecated"><primary sortas="value_set_string_take_ownership">g_value_set_string_take_ownership</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_string_take_ownership (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                                   <parameter><link linkend="gchar"><type>gchar</type></link> *v_string</parameter>);</programlisting>
<warning><para><literal>g_value_set_string_take_ownership</literal> has been deprecated since version 2.4 and should not be used in newly-written code.</para> <para>Use <link linkend="g-value-take-string"><function>g_value_take_string()</function></link> instead.</para>
</warning>
<para>This is an internal function introduced mainly for C marshallers.</para>
<refsect3 id="g-value-set-string-take-ownership.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_string</para></entry>
<entry role="parameter_description"><para>duplicated unowned string to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-string" role="function">
<title>g_value_get_string&#160;()</title>
<indexterm zone="g-value-get-string"><primary sortas="value_get_string">g_value_get_string</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
g_value_get_string (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-string.returns" role="returns">
<title>Returns</title>
<para> string content of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="g-value-dup-string" role="function">
<title>g_value_dup_string&#160;()</title>
<indexterm zone="g-value-dup-string"><primary sortas="value_dup_string">g_value_dup_string</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
g_value_dup_string (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get a copy the contents of a <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-dup-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-dup-string.returns" role="returns">
<title>Returns</title>
<para> a newly allocated copy of the string content of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="g-value-set-interned-string" role="function" condition="since:2.66">
<title>g_value_set_interned_string&#160;()</title>
<indexterm zone="g-value-set-interned-string" role="2.66"><primary sortas="value_set_interned_string">g_value_set_interned_string</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_interned_string (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                             <parameter>const <link linkend="gchar"><type>gchar</type></link> *v_string</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_string</parameter>
.  The string is
assumed to be static and interned (canonical, for example from
<link linkend="g-intern-string"><function>g_intern_string()</function></link>), and is thus not duplicated when setting the <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-set-interned-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-STRING:CAPS"><literal>G_TYPE_STRING</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_string</para></entry>
<entry role="parameter_description"><para>static string to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-PARAM:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_PARAM()</title>
<indexterm zone="G-IS-PARAM-SPEC-PARAM:CAPS"><primary sortas="IS_PARAM_SPEC_PARAM">G_IS_PARAM_SPEC_PARAM</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_PARAM(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_PARAM))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-PARAM:CAPS"><literal>G_TYPE_PARAM_PARAM</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-PARAM.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-PARAM.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-PARAM:CAPS" role="macro">
<title>G_PARAM_SPEC_PARAM()</title>
<indexterm zone="G-PARAM-SPEC-PARAM:CAPS"><primary sortas="PARAM_SPEC_PARAM">G_PARAM_SPEC_PARAM</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_PARAM(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_PARAM, GParamSpecParam))
</programlisting>
<para>Casts a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecParam"><type>GParamSpecParam</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-PARAM.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-PARAM:CAPS" role="macro">
<title>G_VALUE_HOLDS_PARAM()</title>
<indexterm zone="G-VALUE-HOLDS-PARAM:CAPS"><primary sortas="VALUE_HOLDS_PARAM">G_VALUE_HOLDS_PARAM</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_PARAM(value)&#160;(G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_PARAM))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values derived from type <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-PARAM.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-PARAM.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-param" role="function">
<title>g_param_spec_param&#160;()</title>
<indexterm zone="g-param-spec-param"><primary sortas="param_spec_param">g_param_spec_param</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_param (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="GType"><type>GType</type></link> param_type</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecParam"><type>GParamSpecParam</type></link> instance specifying a <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link>
property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-param.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>param_type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GType"><type>GType</type></link> derived from <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-param.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-param" role="function">
<title>g_value_set_param&#160;()</title>
<indexterm zone="g-value-set-param"><primary sortas="value_set_param">g_value_set_param</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_param (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="GParamSpec"><type>GParamSpec</type></link> *param</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>param</parameter>
.</para>
<refsect3 id="g-value-set-param.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>param</para></entry>
<entry role="parameter_description"><para>the <link linkend="GParamSpec"><type>GParamSpec</type></link> to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-take-param" role="function" condition="since:2.4">
<title>g_value_take_param&#160;()</title>
<indexterm zone="g-value-take-param" role="2.4"><primary sortas="value_take_param">g_value_take_param</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_take_param (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                    <parameter><link linkend="GParamSpec"><type>GParamSpec</type></link> *param</parameter>);</programlisting>
<para>Sets the contents of a <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>param</parameter>
 and takes
over the ownership of the caller’s reference to <parameter>param</parameter>
; the caller
doesn’t have to unref it any more.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-value-take-param.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>param</para></entry>
<entry role="parameter_description"><para>the <link linkend="GParamSpec"><type>GParamSpec</type></link> to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="g-value-set-param-take-ownership" role="function" condition="deprecated:2.4: Use g_value_take_param() instead.">
<title>g_value_set_param_take_ownership&#160;()</title>
<indexterm zone="g-value-set-param-take-ownership" role="deprecated"><primary sortas="value_set_param_take_ownership">g_value_set_param_take_ownership</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_param_take_ownership (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                                  <parameter><link linkend="GParamSpec"><type>GParamSpec</type></link> *param</parameter>);</programlisting>
<warning><para><literal>g_value_set_param_take_ownership</literal> has been deprecated since version 2.4 and should not be used in newly-written code.</para> <para>Use <link linkend="g-value-take-param"><function>g_value_take_param()</function></link> instead.</para>
</warning>
<para>This is an internal function introduced mainly for C marshallers.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-value-set-param-take-ownership.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>param</para></entry>
<entry role="parameter_description"><para>the <link linkend="GParamSpec"><type>GParamSpec</type></link> to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-param" role="function">
<title>g_value_get_param&#160;()</title>
<indexterm zone="g-value-get-param"><primary sortas="value_get_param">g_value_get_param</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_value_get_param (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-param.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> whose type is derived from <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-param.returns" role="returns">
<title>Returns</title>
<para><link linkend="GParamSpec"><type>GParamSpec</type></link> content of <parameter>value</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-dup-param" role="function">
<title>g_value_dup_param&#160;()</title>
<indexterm zone="g-value-dup-param"><primary sortas="value_dup_param">g_value_dup_param</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_value_dup_param (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link> <link linkend="GValue"><type>GValue</type></link>, increasing its
reference count.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-value-dup-param.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> whose type is derived from <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-dup-param.returns" role="returns">
<title>Returns</title>
<para> <link linkend="GParamSpec"><type>GParamSpec</type></link> content of <parameter>value</parameter>
, should be unreferenced when
no longer needed.</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-BOXED:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_BOXED()</title>
<indexterm zone="G-IS-PARAM-SPEC-BOXED:CAPS"><primary sortas="IS_PARAM_SPEC_BOXED">G_IS_PARAM_SPEC_BOXED</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_BOXED(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_BOXED))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-BOXED:CAPS"><literal>G_TYPE_PARAM_BOXED</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-BOXED.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-BOXED.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-BOXED:CAPS" role="macro">
<title>G_PARAM_SPEC_BOXED()</title>
<indexterm zone="G-PARAM-SPEC-BOXED:CAPS"><primary sortas="PARAM_SPEC_BOXED">G_PARAM_SPEC_BOXED</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_BOXED(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_BOXED, GParamSpecBoxed))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecBoxed"><type>GParamSpecBoxed</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-BOXED.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-BOXED:CAPS" role="macro">
<title>G_VALUE_HOLDS_BOXED()</title>
<indexterm zone="G-VALUE-HOLDS-BOXED:CAPS"><primary sortas="VALUE_HOLDS_BOXED">G_VALUE_HOLDS_BOXED</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_BOXED(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_BOXED))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values derived
from type <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-BOXED.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-BOXED.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-boxed" role="function">
<title>g_param_spec_boxed&#160;()</title>
<indexterm zone="g-param-spec-boxed"><primary sortas="param_spec_boxed">g_param_spec_boxed</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_boxed (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="GType"><type>GType</type></link> boxed_type</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecBoxed"><type>GParamSpecBoxed</type></link> instance specifying a <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link>
derived property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-boxed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>boxed_type</para></entry>
<entry role="parameter_description"><para><link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived type of this property</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-boxed.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-boxed" role="function">
<title>g_value_set_boxed&#160;()</title>
<indexterm zone="g-value-set-boxed"><primary sortas="value_set_boxed">g_value_set_boxed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_boxed (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> v_boxed</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived <link linkend="GValue"><type>GValue</type></link> to <parameter>v_boxed</parameter>
.</para>
<refsect3 id="g-value-set-boxed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_boxed</para></entry>
<entry role="parameter_description"><para>boxed value to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-set-static-boxed" role="function">
<title>g_value_set_static_boxed&#160;()</title>
<indexterm zone="g-value-set-static-boxed"><primary sortas="value_set_static_boxed">g_value_set_static_boxed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_static_boxed (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                          <parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> v_boxed</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived <link linkend="GValue"><type>GValue</type></link> to <parameter>v_boxed</parameter>
.
The boxed value is assumed to be static, and is thus not duplicated
when setting the <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-set-static-boxed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_boxed</para></entry>
<entry role="parameter_description"><para>static boxed value to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-take-boxed" role="function" condition="since:2.4">
<title>g_value_take_boxed&#160;()</title>
<indexterm zone="g-value-take-boxed" role="2.4"><primary sortas="value_take_boxed">g_value_take_boxed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_take_boxed (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                    <parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> v_boxed</parameter>);</programlisting>
<para>Sets the contents of a <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived <link linkend="GValue"><type>GValue</type></link> to <parameter>v_boxed</parameter>

and takes over the ownership of the caller’s reference to <parameter>v_boxed</parameter>
;
the caller doesn’t have to unref it any more.</para>
<refsect3 id="g-value-take-boxed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_boxed</para></entry>
<entry role="parameter_description"><para>duplicated unowned boxed value to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="g-value-set-boxed-take-ownership" role="function" condition="deprecated:2.4: Use g_value_take_boxed() instead.">
<title>g_value_set_boxed_take_ownership&#160;()</title>
<indexterm zone="g-value-set-boxed-take-ownership" role="deprecated"><primary sortas="value_set_boxed_take_ownership">g_value_set_boxed_take_ownership</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_boxed_take_ownership (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                                  <parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> v_boxed</parameter>);</programlisting>
<warning><para><literal>g_value_set_boxed_take_ownership</literal> has been deprecated since version 2.4 and should not be used in newly-written code.</para> <para>Use <link linkend="g-value-take-boxed"><function>g_value_take_boxed()</function></link> instead.</para>
</warning>
<para>This is an internal function introduced mainly for C marshallers.</para>
<refsect3 id="g-value-set-boxed-take-ownership.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_boxed</para></entry>
<entry role="parameter_description"><para>duplicated unowned boxed value to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-boxed" role="function">
<title>g_value_get_boxed&#160;()</title>
<indexterm zone="g-value-get-boxed"><primary sortas="value_get_boxed">g_value_get_boxed</primary></indexterm>
<programlisting language="C"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
g_value_get_boxed (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-boxed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-boxed.returns" role="returns">
<title>Returns</title>
<para>boxed contents of <parameter>value</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-dup-boxed" role="function">
<title>g_value_dup_boxed&#160;()</title>
<indexterm zone="g-value-dup-boxed"><primary sortas="value_dup_boxed">g_value_dup_boxed</primary></indexterm>
<programlisting language="C"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
g_value_dup_boxed (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived <link linkend="GValue"><type>GValue</type></link>.  Upon getting,
the boxed value is duplicated and needs to be later freed with
<link linkend="g-boxed-free"><function>g_boxed_free()</function></link>, e.g. like: g_boxed_free (G_VALUE_TYPE (<parameter>value</parameter>
),
return_value);</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-value-dup-boxed.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-dup-boxed.returns" role="returns">
<title>Returns</title>
<para> boxed contents of <parameter>value</parameter>
</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-POINTER:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_POINTER()</title>
<indexterm zone="G-IS-PARAM-SPEC-POINTER:CAPS"><primary sortas="IS_PARAM_SPEC_POINTER">G_IS_PARAM_SPEC_POINTER</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_POINTER(pspec)     (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_POINTER))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-POINTER:CAPS"><literal>G_TYPE_PARAM_POINTER</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-POINTER.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-POINTER.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-POINTER:CAPS" role="macro">
<title>G_PARAM_SPEC_POINTER()</title>
<indexterm zone="G-PARAM-SPEC-POINTER:CAPS"><primary sortas="PARAM_SPEC_POINTER">G_PARAM_SPEC_POINTER</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_POINTER(pspec)        (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_POINTER, GParamSpecPointer))
</programlisting>
<para>Casts a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecPointer"><type>GParamSpecPointer</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-POINTER.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-POINTER:CAPS" role="macro">
<title>G_VALUE_HOLDS_POINTER()</title>
<indexterm zone="G-VALUE-HOLDS-POINTER:CAPS"><primary sortas="VALUE_HOLDS_POINTER">G_VALUE_HOLDS_POINTER</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_POINTER(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_POINTER))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-POINTER:CAPS"><literal>G_TYPE_POINTER</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-POINTER.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-POINTER.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-pointer" role="function">
<title>g_param_spec_pointer&#160;()</title>
<indexterm zone="g-param-spec-pointer"><primary sortas="param_spec_pointer">g_param_spec_pointer</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_pointer (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                      <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecPointer"><type>GParamSpecPointer</type></link> instance specifying a pointer property.
Where possible, it is better to use <link linkend="g-param-spec-object"><function>g_param_spec_object()</function></link> or
<link linkend="g-param-spec-boxed"><function>g_param_spec_boxed()</function></link> to expose memory management information.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-pointer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-pointer.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-pointer" role="function">
<title>g_value_set_pointer&#160;()</title>
<indexterm zone="g-value-set-pointer"><primary sortas="value_set_pointer">g_value_set_pointer</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_pointer (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                     <parameter><link linkend="gpointer"><type>gpointer</type></link> v_pointer</parameter>);</programlisting>
<para>Set the contents of a pointer <link linkend="GValue"><type>GValue</type></link> to <parameter>v_pointer</parameter>
.</para>
<refsect3 id="g-value-set-pointer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-POINTER:CAPS"><literal>G_TYPE_POINTER</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_pointer</para></entry>
<entry role="parameter_description"><para>pointer value to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-pointer" role="function">
<title>g_value_get_pointer&#160;()</title>
<indexterm zone="g-value-get-pointer"><primary sortas="value_get_pointer">g_value_get_pointer</primary></indexterm>
<programlisting language="C"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
g_value_get_pointer (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a pointer <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-pointer.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-POINTER:CAPS"><literal>G_TYPE_POINTER</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-pointer.returns" role="returns">
<title>Returns</title>
<para>pointer contents of <parameter>value</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-OBJECT:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_OBJECT()</title>
<indexterm zone="G-IS-PARAM-SPEC-OBJECT:CAPS"><primary sortas="IS_PARAM_SPEC_OBJECT">G_IS_PARAM_SPEC_OBJECT</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_OBJECT(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OBJECT))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-OBJECT:CAPS"><literal>G_TYPE_PARAM_OBJECT</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-OBJECT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-OBJECT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-OBJECT:CAPS" role="macro">
<title>G_PARAM_SPEC_OBJECT()</title>
<indexterm zone="G-PARAM-SPEC-OBJECT:CAPS"><primary sortas="PARAM_SPEC_OBJECT">G_PARAM_SPEC_OBJECT</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_OBJECT(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OBJECT, GParamSpecObject))
</programlisting>
<para>Casts a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecObject"><type>GParamSpecObject</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-OBJECT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="G-VALUE-HOLDS-OBJECT:CAPS" role="macro">
<title>G_VALUE_HOLDS_OBJECT()</title>
<indexterm zone="G-VALUE-HOLDS-OBJECT:CAPS"><primary sortas="VALUE_HOLDS_OBJECT">G_VALUE_HOLDS_OBJECT</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_OBJECT(value) (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_OBJECT))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values derived from type <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-OBJECT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-OBJECT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="g-param-spec-object" role="function">
<title>g_param_spec_object&#160;()</title>
<indexterm zone="g-param-spec-object"><primary sortas="param_spec_object">g_param_spec_object</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_object (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                     <parameter><link linkend="GType"><type>GType</type></link> object_type</parameter>,
                     <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecBoxed"><type>GParamSpecBoxed</type></link> instance specifying a <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link>
derived property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-object.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>object_type</para></entry>
<entry role="parameter_description"><para><link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived type of this property</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-object.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-set-object" role="function">
<title>g_value_set_object&#160;()</title>
<indexterm zone="g-value-set-object"><primary sortas="value_set_object">g_value_set_object</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_object (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                    <parameter><link linkend="gpointer"><type>gpointer</type></link> v_object</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived <link linkend="GValue"><type>GValue</type></link> to <parameter>v_object</parameter>
.</para>
<para>g_value_set_object() increases the reference count of <parameter>v_object</parameter>

(the <link linkend="GValue"><type>GValue</type></link> holds a reference to <parameter>v_object</parameter>
).  If you do not wish
to increase the reference count of the object (i.e. you wish to
pass your current reference to the <link linkend="GValue"><type>GValue</type></link> because you no longer
need it), use <link linkend="g-value-take-object"><function>g_value_take_object()</function></link> instead.</para>
<para>It is important that your <link linkend="GValue"><type>GValue</type></link> holds a reference to <parameter>v_object</parameter>
 (either its
own, or one it has taken) to ensure that the object won't be destroyed while
the <link linkend="GValue"><type>GValue</type></link> still exists).</para>
<refsect3 id="g-value-set-object.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_object</para></entry>
<entry role="parameter_description"><para>object value to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>type</acronym> GObject.Object][<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-take-object" role="function" condition="since:2.4">
<title>g_value_take_object&#160;()</title>
<indexterm zone="g-value-take-object" role="2.4"><primary sortas="value_take_object">g_value_take_object</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_take_object (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                     <parameter><link linkend="gpointer"><type>gpointer</type></link> v_object</parameter>);</programlisting>
<para>Sets the contents of a <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived <link linkend="GValue"><type>GValue</type></link> to <parameter>v_object</parameter>

and takes over the ownership of the caller’s reference to <parameter>v_object</parameter>
;
the caller doesn’t have to unref it any more (i.e. the reference
count of the object is not increased).</para>
<para>If you want the <link linkend="GValue"><type>GValue</type></link> to hold its own reference to <parameter>v_object</parameter>
, use
<link linkend="g-value-set-object"><function>g_value_set_object()</function></link> instead.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-value-take-object.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_object</para></entry>
<entry role="parameter_description"><para>object value to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="g-value-set-object-take-ownership" role="function" condition="deprecated:2.4: Use g_value_take_object() instead.">
<title>g_value_set_object_take_ownership&#160;()</title>
<indexterm zone="g-value-set-object-take-ownership" role="deprecated"><primary sortas="value_set_object_take_ownership">g_value_set_object_take_ownership</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_object_take_ownership (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                                   <parameter><link linkend="gpointer"><type>gpointer</type></link> v_object</parameter>);</programlisting>
<warning><para><literal>g_value_set_object_take_ownership</literal> has been deprecated since version 2.4 and should not be used in newly-written code.</para> <para>Use <link linkend="g-value-take-object"><function>g_value_take_object()</function></link> instead.</para>
</warning>
<para>This is an internal function introduced mainly for C marshallers.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-value-set-object-take-ownership.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_object</para></entry>
<entry role="parameter_description"><para>object value to be set. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-value-get-object" role="function">
<title>g_value_get_object&#160;()</title>
<indexterm zone="g-value-get-object"><primary sortas="value_get_object">g_value_get_object</primary></indexterm>
<programlisting language="C"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
g_value_get_object (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-object.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived type</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-object.returns" role="returns">
<title>Returns</title>
<para>object contents of <parameter>value</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>type</acronym> GObject.Object][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="g-value-dup-object" role="function">
<title>g_value_dup_object&#160;()</title>
<indexterm zone="g-value-dup-object"><primary sortas="value_dup_object">g_value_dup_object</primary></indexterm>
<programlisting language="C"><link linkend="gpointer"><returnvalue>gpointer</returnvalue></link>
g_value_dup_object (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link> derived <link linkend="GValue"><type>GValue</type></link>, increasing
its reference count. If the contents of the <link linkend="GValue"><type>GValue</type></link> are <link linkend="NULL:CAPS"><literal>NULL</literal></link>, then
<link linkend="NULL:CAPS"><literal>NULL</literal></link> will be returned.</para>
<refsect3 id="g-value-dup-object.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> whose type is derived from <link linkend="G-TYPE-OBJECT:CAPS"><literal>G_TYPE_OBJECT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-dup-object.returns" role="returns">
<title>Returns</title>
<para>object content of <parameter>value</parameter>
,
should be unreferenced when no longer needed. </para>
<para><emphasis role="annotation">[<acronym>type</acronym> GObject.Object][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-UNICHAR:CAPS" role="macro">
<title>G_IS_PARAM_SPEC_UNICHAR()</title>
<indexterm zone="G-IS-PARAM-SPEC-UNICHAR:CAPS"><primary sortas="IS_PARAM_SPEC_UNICHAR">G_IS_PARAM_SPEC_UNICHAR</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_UNICHAR(pspec)     (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_UNICHAR))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-UNICHAR:CAPS"><literal>G_TYPE_PARAM_UNICHAR</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-UNICHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-UNICHAR.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-UNICHAR:CAPS" role="macro">
<title>G_PARAM_SPEC_UNICHAR()</title>
<indexterm zone="G-PARAM-SPEC-UNICHAR:CAPS"><primary sortas="PARAM_SPEC_UNICHAR">G_PARAM_SPEC_UNICHAR</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_UNICHAR(pspec)        (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_UNICHAR, GParamSpecUnichar))
</programlisting>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecUnichar"><type>GParamSpecUnichar</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-UNICHAR.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-param-spec-unichar" role="function">
<title>g_param_spec_unichar&#160;()</title>
<indexterm zone="g-param-spec-unichar"><primary sortas="param_spec_unichar">g_param_spec_unichar</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_unichar (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                      <parameter><link linkend="gunichar"><type>gunichar</type></link> default_value</parameter>,
                      <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecUnichar"><type>GParamSpecUnichar</type></link> instance specifying a <link linkend="G-TYPE-UINT:CAPS"><literal>G_TYPE_UINT</literal></link>
property. <link linkend="GValue"><type>GValue</type></link> structures for this property can be accessed with
<link linkend="g-value-set-uint"><function>g_value_set_uint()</function></link> and <link linkend="g-value-get-uint"><function>g_value_get_uint()</function></link>.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-unichar.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>default value for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-unichar.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-VALUE-ARRAY:CAPS" role="macro" condition="deprecated:2.32: Use #GArray instead of #GValueArray">
<title>G_IS_PARAM_SPEC_VALUE_ARRAY()</title>
<indexterm zone="G-IS-PARAM-SPEC-VALUE-ARRAY:CAPS" role="deprecated"><primary sortas="IS_PARAM_SPEC_VALUE_ARRAY">G_IS_PARAM_SPEC_VALUE_ARRAY</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_VALUE_ARRAY(pspec) (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_VALUE_ARRAY)) GLIB_DEPRECATED_MACRO_IN_2_32
</programlisting>
<warning><para><literal>G_IS_PARAM_SPEC_VALUE_ARRAY</literal> has been deprecated since version 2.32 and should not be used in newly-written code.</para> <para>Use <link linkend="GArray"><type>GArray</type></link> instead of <link linkend="GValueArray"><type>GValueArray</type></link></para>
</warning>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-VALUE-ARRAY:CAPS"><literal>G_TYPE_PARAM_VALUE_ARRAY</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-VALUE-ARRAY.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-VALUE-ARRAY.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3></refsect2>
<refsect2 id="G-PARAM-SPEC-VALUE-ARRAY:CAPS" role="macro" condition="deprecated:2.32: Use #GArray instead of #GValueArray">
<title>G_PARAM_SPEC_VALUE_ARRAY()</title>
<indexterm zone="G-PARAM-SPEC-VALUE-ARRAY:CAPS" role="deprecated"><primary sortas="PARAM_SPEC_VALUE_ARRAY">G_PARAM_SPEC_VALUE_ARRAY</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_VALUE_ARRAY(pspec)    (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_VALUE_ARRAY, GParamSpecValueArray)) GLIB_DEPRECATED_MACRO_IN_2_32
</programlisting>
<warning><para><literal>G_PARAM_SPEC_VALUE_ARRAY</literal> has been deprecated since version 2.32 and should not be used in newly-written code.</para> <para>Use <link linkend="GArray"><type>GArray</type></link> instead of <link linkend="GValueArray"><type>GValueArray</type></link></para>
</warning>
<para>Cast a <link linkend="GParamSpec"><type>GParamSpec</type></link> instance into a <link linkend="GParamSpecValueArray"><type>GParamSpecValueArray</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-VALUE-ARRAY.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GParamSpec"><type>GParamSpec</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="g-param-spec-value-array" role="function">
<title>g_param_spec_value_array&#160;()</title>
<indexterm zone="g-param-spec-value-array"><primary sortas="param_spec_value_array">g_param_spec_value_array</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_value_array (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                          <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                          <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                          <parameter><link linkend="GParamSpec"><type>GParamSpec</type></link> *element_spec</parameter>,
                          <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecValueArray"><type>GParamSpecValueArray</type></link> instance specifying a
<link linkend="G-TYPE-VALUE-ARRAY:CAPS"><literal>G_TYPE_VALUE_ARRAY</literal></link> property. <link linkend="G-TYPE-VALUE-ARRAY:CAPS"><literal>G_TYPE_VALUE_ARRAY</literal></link> is a
<link linkend="G-TYPE-BOXED:CAPS"><literal>G_TYPE_BOXED</literal></link> type, as such, <link linkend="GValue"><type>GValue</type></link> structures for this property
can be accessed with <link linkend="g-value-set-boxed"><function>g_value_set_boxed()</function></link> and <link linkend="g-value-get-boxed"><function>g_value_get_boxed()</function></link>.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-param-spec-value-array.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>element_spec</para></entry>
<entry role="parameter_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link> describing the elements contained in
arrays of this property, may be <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-value-array.returns" role="returns">
<title>Returns</title>
<para> a newly created parameter specification</para>
</refsect3></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-OVERRIDE:CAPS" role="macro" condition="since:2.4">
<title>G_IS_PARAM_SPEC_OVERRIDE()</title>
<indexterm zone="G-IS-PARAM-SPEC-OVERRIDE:CAPS" role="2.4"><primary sortas="IS_PARAM_SPEC_OVERRIDE">G_IS_PARAM_SPEC_OVERRIDE</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_OVERRIDE(pspec)    (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_OVERRIDE))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-OVERRIDE:CAPS"><literal>G_TYPE_PARAM_OVERRIDE</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-OVERRIDE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-OVERRIDE.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="G-PARAM-SPEC-OVERRIDE:CAPS" role="macro" condition="since:2.4">
<title>G_PARAM_SPEC_OVERRIDE()</title>
<indexterm zone="G-PARAM-SPEC-OVERRIDE:CAPS" role="2.4"><primary sortas="PARAM_SPEC_OVERRIDE">G_PARAM_SPEC_OVERRIDE</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_OVERRIDE(pspec)       (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_OVERRIDE, GParamSpecOverride))
</programlisting>
<para>Casts a <link linkend="GParamSpec"><type>GParamSpec</type></link> into a <link linkend="GParamSpecOverride"><type>GParamSpecOverride</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-OVERRIDE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="g-param-spec-override" role="function" condition="since:2.4">
<title>g_param_spec_override&#160;()</title>
<indexterm zone="g-param-spec-override" role="2.4"><primary sortas="param_spec_override">g_param_spec_override</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_override (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                       <parameter><link linkend="GParamSpec"><type>GParamSpec</type></link> *overridden</parameter>);</programlisting>
<para>Creates a new property of type <link linkend="GParamSpecOverride"><type>GParamSpecOverride</type></link>. This is used
to direct operations to another paramspec, and will not be directly
useful unless you are implementing a new base type similar to GObject.</para>

<para><emphasis role="annotation">[<acronym>skip</acronym>]</emphasis></para><refsect3 id="g-param-spec-override.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the property.</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>overridden</para></entry>
<entry role="parameter_description"><para>The property that is being overridden</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-override.returns" role="returns">
<title>Returns</title>
<para> the newly created <link linkend="GParamSpec"><type>GParamSpec</type></link></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-GTYPE:CAPS" role="macro" condition="since:2.10">
<title>G_IS_PARAM_SPEC_GTYPE()</title>
<indexterm zone="G-IS-PARAM-SPEC-GTYPE:CAPS" role="2.10"><primary sortas="IS_PARAM_SPEC_GTYPE">G_IS_PARAM_SPEC_GTYPE</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_GTYPE(pspec)       (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_GTYPE))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-GTYPE:CAPS"><literal>G_TYPE_PARAM_GTYPE</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-GTYPE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-GTYPE.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success. </para>
</refsect3><para role="since">Since: <link linkend="api-index-2.10">2.10</link></para></refsect2>
<refsect2 id="G-PARAM-SPEC-GTYPE:CAPS" role="macro" condition="since:2.10">
<title>G_PARAM_SPEC_GTYPE()</title>
<indexterm zone="G-PARAM-SPEC-GTYPE:CAPS" role="2.10"><primary sortas="PARAM_SPEC_GTYPE">G_PARAM_SPEC_GTYPE</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_GTYPE(pspec)          (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_GTYPE, GParamSpecGType))
</programlisting>
<para>Casts a <link linkend="GParamSpec"><type>GParamSpec</type></link> into a <link linkend="GParamSpecGType"><type>GParamSpecGType</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-GTYPE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.10">2.10</link></para></refsect2>
<refsect2 id="G-VALUE-HOLDS-GTYPE:CAPS" role="macro" condition="since:2.12">
<title>G_VALUE_HOLDS_GTYPE()</title>
<indexterm zone="G-VALUE-HOLDS-GTYPE:CAPS" role="2.12"><primary sortas="VALUE_HOLDS_GTYPE">G_VALUE_HOLDS_GTYPE</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_GTYPE(value)	 (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_GTYPE))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-GTYPE:CAPS"><literal>G_TYPE_GTYPE</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-GTYPE.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-GTYPE.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-param-spec-gtype" role="function" condition="since:2.10">
<title>g_param_spec_gtype&#160;()</title>
<indexterm zone="g-param-spec-gtype" role="2.10"><primary sortas="param_spec_gtype">g_param_spec_gtype</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_gtype (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                    <parameter><link linkend="GType"><type>GType</type></link> is_a_type</parameter>,
                    <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecGType"><type>GParamSpecGType</type></link> instance specifying a
<link linkend="G-TYPE-GTYPE:CAPS"><literal>G_TYPE_GTYPE</literal></link> property.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-gtype.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>is_a_type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GType"><type>GType</type></link> whose subtypes are allowed as values
of the property (use <link linkend="G-TYPE-NONE:CAPS"><literal>G_TYPE_NONE</literal></link> for any type)</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-gtype.returns" role="returns">
<title>Returns</title>
<para>a newly created parameter specification. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.10">2.10</link></para></refsect2>
<refsect2 id="g-value-get-gtype" role="function" condition="since:2.12">
<title>g_value_get_gtype&#160;()</title>
<indexterm zone="g-value-get-gtype" role="2.12"><primary sortas="value_get_gtype">g_value_get_gtype</primary></indexterm>
<programlisting language="C"><link linkend="GType"><returnvalue>GType</returnvalue></link>
g_value_get_gtype (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a <link linkend="G-TYPE-GTYPE:CAPS"><literal>G_TYPE_GTYPE</literal></link> <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-gtype.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-GTYPE:CAPS"><literal>G_TYPE_GTYPE</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-gtype.returns" role="returns">
<title>Returns</title>
<para> the <link linkend="GType"><type>GType</type></link> stored in <parameter>value</parameter>
</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="g-value-set-gtype" role="function" condition="since:2.12">
<title>g_value_set_gtype&#160;()</title>
<indexterm zone="g-value-set-gtype" role="2.12"><primary sortas="value_set_gtype">g_value_set_gtype</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_gtype (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                   <parameter><link linkend="GType"><type>GType</type></link> v_gtype</parameter>);</programlisting>
<para>Set the contents of a <link linkend="G-TYPE-GTYPE:CAPS"><literal>G_TYPE_GTYPE</literal></link> <link linkend="GValue"><type>GValue</type></link> to <parameter>v_gtype</parameter>
.</para>
<refsect3 id="g-value-set-gtype.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-GTYPE:CAPS"><literal>G_TYPE_GTYPE</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>v_gtype</para></entry>
<entry role="parameter_description"><para><link linkend="GType"><type>GType</type></link> to be set</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.12">2.12</link></para></refsect2>
<refsect2 id="G-IS-PARAM-SPEC-VARIANT:CAPS" role="macro" condition="since:2.26">
<title>G_IS_PARAM_SPEC_VARIANT()</title>
<indexterm zone="G-IS-PARAM-SPEC-VARIANT:CAPS" role="2.26"><primary sortas="IS_PARAM_SPEC_VARIANT">G_IS_PARAM_SPEC_VARIANT</primary></indexterm>
<programlisting language="C">#define G_IS_PARAM_SPEC_VARIANT(pspec)      (G_TYPE_CHECK_INSTANCE_TYPE ((pspec), G_TYPE_PARAM_VARIANT))
</programlisting>
<para>Checks whether the given <link linkend="GParamSpec"><type>GParamSpec</type></link> is of type <link linkend="G-TYPE-PARAM-VARIANT:CAPS"><literal>G_TYPE_PARAM_VARIANT</literal></link>.</para>
<refsect3 id="G-IS-PARAM-SPEC-VARIANT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-IS-PARAM-SPEC-VARIANT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="G-PARAM-SPEC-VARIANT:CAPS" role="macro" condition="since:2.26">
<title>G_PARAM_SPEC_VARIANT()</title>
<indexterm zone="G-PARAM-SPEC-VARIANT:CAPS" role="2.26"><primary sortas="PARAM_SPEC_VARIANT">G_PARAM_SPEC_VARIANT</primary></indexterm>
<programlisting language="C">#define G_PARAM_SPEC_VARIANT(pspec)         (G_TYPE_CHECK_INSTANCE_CAST ((pspec), G_TYPE_PARAM_VARIANT, GParamSpecVariant))
</programlisting>
<para>Casts a <link linkend="GParamSpec"><type>GParamSpec</type></link> into a <link linkend="GParamSpecVariant"><type>GParamSpecVariant</type></link>.</para>
<refsect3 id="G-PARAM-SPEC-VARIANT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>pspec</para></entry>
<entry role="parameter_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="G-VALUE-HOLDS-VARIANT:CAPS" role="macro" condition="since:2.26">
<title>G_VALUE_HOLDS_VARIANT()</title>
<indexterm zone="G-VALUE-HOLDS-VARIANT:CAPS" role="2.26"><primary sortas="VALUE_HOLDS_VARIANT">G_VALUE_HOLDS_VARIANT</primary></indexterm>
<programlisting language="C">#define G_VALUE_HOLDS_VARIANT(value)     (G_TYPE_CHECK_VALUE_TYPE ((value), G_TYPE_VARIANT))
</programlisting>
<para>Checks whether the given <link linkend="GValue"><type>GValue</type></link> can hold values of type <link linkend="G-TYPE-VARIANT:CAPS"><literal>G_TYPE_VARIANT</literal></link>.</para>
<refsect3 id="G-VALUE-HOLDS-VARIANT.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> structure</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="G-VALUE-HOLDS-VARIANT.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.</para>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="g-param-spec-variant" role="function" condition="since:2.26">
<title>g_param_spec_variant&#160;()</title>
<indexterm zone="g-param-spec-variant" role="2.26"><primary sortas="param_spec_variant">g_param_spec_variant</primary></indexterm>
<programlisting language="C"><link linkend="GParamSpec"><returnvalue>GParamSpec</returnvalue></link>&#160;*
g_param_spec_variant (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *nick</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *blurb</parameter>,
                      <parameter>const <link linkend="GVariantType"><type>GVariantType</type></link> *type</parameter>,
                      <parameter><link linkend="GVariant"><type>GVariant</type></link> *default_value</parameter>,
                      <parameter><link linkend="GParamFlags"><type>GParamFlags</type></link> flags</parameter>);</programlisting>
<para>Creates a new <link linkend="GParamSpecVariant"><type>GParamSpecVariant</type></link> instance specifying a <link linkend="GVariant"><type>GVariant</type></link>
property.</para>
<para>If <parameter>default_value</parameter>
 is floating, it is consumed.</para>
<para>See <link linkend="g-param-spec-internal"><function>g_param_spec_internal()</function></link> for details on property names.</para>
<refsect3 id="g-param-spec-variant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>canonical name of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>nick</para></entry>
<entry role="parameter_description"><para>nick name for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>blurb</para></entry>
<entry role="parameter_description"><para>description of the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>a <link linkend="GVariantType"><type>GVariantType</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>default_value</para></entry>
<entry role="parameter_description"><para>a <link linkend="GVariant"><type>GVariant</type></link> of type <parameter>type</parameter>
to
use as the default value, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags for the property specified</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-param-spec-variant.returns" role="returns">
<title>Returns</title>
<para>the newly created <link linkend="GParamSpec"><type>GParamSpec</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="g-value-get-variant" role="function" condition="since:2.26">
<title>g_value_get_variant&#160;()</title>
<indexterm zone="g-value-get-variant" role="2.26"><primary sortas="value_get_variant">g_value_get_variant</primary></indexterm>
<programlisting language="C"><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link>&#160;*
g_value_get_variant (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a variant <link linkend="GValue"><type>GValue</type></link>.</para>
<refsect3 id="g-value-get-variant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-VARIANT:CAPS"><literal>G_TYPE_VARIANT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-get-variant.returns" role="returns">
<title>Returns</title>
<para>variant contents of <parameter>value</parameter>
(may be <link linkend="NULL:CAPS"><literal>NULL</literal></link>). </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="g-value-dup-variant" role="function" condition="since:2.26">
<title>g_value_dup_variant&#160;()</title>
<indexterm zone="g-value-dup-variant" role="2.26"><primary sortas="value_dup_variant">g_value_dup_variant</primary></indexterm>
<programlisting language="C"><link linkend="GVariant"><returnvalue>GVariant</returnvalue></link>&#160;*
g_value_dup_variant (<parameter>const <link linkend="GValue"><type>GValue</type></link> *value</parameter>);</programlisting>
<para>Get the contents of a variant <link linkend="GValue"><type>GValue</type></link>, increasing its refcount. The returned
<link linkend="GVariant"><type>GVariant</type></link> is never floating.</para>
<refsect3 id="g-value-dup-variant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-VARIANT:CAPS"><literal>G_TYPE_VARIANT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="g-value-dup-variant.returns" role="returns">
<title>Returns</title>
<para>variant contents of <parameter>value</parameter>
(may be <link linkend="NULL:CAPS"><literal>NULL</literal></link>);
should be unreffed using <link linkend="g-variant-unref"><function>g_variant_unref()</function></link> when no longer needed. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>][<acronym>nullable</acronym>]</emphasis></para>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="g-value-set-variant" role="function" condition="since:2.26">
<title>g_value_set_variant&#160;()</title>
<indexterm zone="g-value-set-variant" role="2.26"><primary sortas="value_set_variant">g_value_set_variant</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_set_variant (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                     <parameter><link linkend="GVariant"><type>GVariant</type></link> *variant</parameter>);</programlisting>
<para>Set the contents of a variant <link linkend="GValue"><type>GValue</type></link> to <parameter>variant</parameter>
.
If the variant is floating, it is consumed.</para>
<refsect3 id="g-value-set-variant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-VARIANT:CAPS"><literal>G_TYPE_VARIANT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>variant</para></entry>
<entry role="parameter_description"><para>a <link linkend="GVariant"><type>GVariant</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="g-value-take-variant" role="function" condition="since:2.26">
<title>g_value_take_variant&#160;()</title>
<indexterm zone="g-value-take-variant" role="2.26"><primary sortas="value_take_variant">g_value_take_variant</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
g_value_take_variant (<parameter><link linkend="GValue"><type>GValue</type></link> *value</parameter>,
                      <parameter><link linkend="GVariant"><type>GVariant</type></link> *variant</parameter>);</programlisting>
<para>Set the contents of a variant <link linkend="GValue"><type>GValue</type></link> to <parameter>variant</parameter>
, and takes over
the ownership of the caller's reference to <parameter>variant</parameter>
;
the caller doesn't have to unref it any more (i.e. the reference
count of the variant is not increased).</para>
<para>If <parameter>variant</parameter>
 was floating then its floating reference is converted to
a hard reference.</para>
<para>If you want the <link linkend="GValue"><type>GValue</type></link> to hold its own reference to <parameter>variant</parameter>
, use
<link linkend="g-value-set-variant"><function>g_value_set_variant()</function></link> instead.</para>
<para>This is an internal function introduced mainly for C marshallers.</para>
<refsect3 id="g-value-take-variant.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>value</para></entry>
<entry role="parameter_description"><para>a valid <link linkend="GValue"><type>GValue</type></link> of type <link linkend="G-TYPE-VARIANT:CAPS"><literal>G_TYPE_VARIANT</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>variant</para></entry>
<entry role="parameter_description"><para>a <link linkend="GVariant"><type>GVariant</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>

</refsect1>
<refsect1 id="gobject-Standard-Parameter-and-Value-Types.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="G-TYPE-PARAM-BOOLEAN:CAPS" role="macro">
<title>G_TYPE_PARAM_BOOLEAN</title>
<indexterm zone="G-TYPE-PARAM-BOOLEAN:CAPS"><primary sortas="TYPE_PARAM_BOOLEAN">G_TYPE_PARAM_BOOLEAN</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_BOOLEAN		   (g_param_spec_types[2])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecBoolean"><type>GParamSpecBoolean</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecBoolean" role="struct">
<title>struct GParamSpecBoolean</title>
<indexterm zone="GParamSpecBoolean"><primary sortas="ParamSpecBoolean">GParamSpecBoolean</primary></indexterm>
<programlisting language="C">struct GParamSpecBoolean {
  GParamSpec    parent_instance;

  gboolean      default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for boolean properties.</para>
<refsect3 id="GParamSpecBoolean.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gboolean"><type>gboolean</type></link>&#160;<structfield id="GParamSpecBoolean.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-CHAR:CAPS" role="macro">
<title>G_TYPE_PARAM_CHAR</title>
<indexterm zone="G-TYPE-PARAM-CHAR:CAPS"><primary sortas="TYPE_PARAM_CHAR">G_TYPE_PARAM_CHAR</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_CHAR		   (g_param_spec_types[0])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecChar"><type>GParamSpecChar</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecChar" role="struct">
<title>struct GParamSpecChar</title>
<indexterm zone="GParamSpecChar"><primary sortas="ParamSpecChar">GParamSpecChar</primary></indexterm>
<programlisting language="C">struct GParamSpecChar {
  GParamSpec    parent_instance;

  gint8         minimum;
  gint8         maximum;
  gint8         default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for character properties.</para>
<refsect3 id="GParamSpecChar.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint8"><type>gint8</type></link>&#160;<structfield id="GParamSpecChar.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint8"><type>gint8</type></link>&#160;<structfield id="GParamSpecChar.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint8"><type>gint8</type></link>&#160;<structfield id="GParamSpecChar.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-UCHAR:CAPS" role="macro">
<title>G_TYPE_PARAM_UCHAR</title>
<indexterm zone="G-TYPE-PARAM-UCHAR:CAPS"><primary sortas="TYPE_PARAM_UCHAR">G_TYPE_PARAM_UCHAR</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_UCHAR		   (g_param_spec_types[1])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecUChar"><type>GParamSpecUChar</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecUChar" role="struct">
<title>struct GParamSpecUChar</title>
<indexterm zone="GParamSpecUChar"><primary sortas="ParamSpecUChar">GParamSpecUChar</primary></indexterm>
<programlisting language="C">struct GParamSpecUChar {
  GParamSpec    parent_instance;

  guint8        minimum;
  guint8        maximum;
  guint8        default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for unsigned character properties.</para>
<refsect3 id="GParamSpecUChar.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint8"><type>guint8</type></link>&#160;<structfield id="GParamSpecUChar.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint8"><type>guint8</type></link>&#160;<structfield id="GParamSpecUChar.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint8"><type>guint8</type></link>&#160;<structfield id="GParamSpecUChar.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-INT:CAPS" role="macro">
<title>G_TYPE_PARAM_INT</title>
<indexterm zone="G-TYPE-PARAM-INT:CAPS"><primary sortas="TYPE_PARAM_INT">G_TYPE_PARAM_INT</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_INT		   (g_param_spec_types[3])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecInt"><type>GParamSpecInt</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecInt" role="struct">
<title>struct GParamSpecInt</title>
<indexterm zone="GParamSpecInt"><primary sortas="ParamSpecInt">GParamSpecInt</primary></indexterm>
<programlisting language="C">struct GParamSpecInt {
  GParamSpec    parent_instance;

  gint          minimum;
  gint          maximum;
  gint          default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for integer properties.</para>
<refsect3 id="GParamSpecInt.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GParamSpecInt.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GParamSpecInt.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GParamSpecInt.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-UINT:CAPS" role="macro">
<title>G_TYPE_PARAM_UINT</title>
<indexterm zone="G-TYPE-PARAM-UINT:CAPS"><primary sortas="TYPE_PARAM_UINT">G_TYPE_PARAM_UINT</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_UINT		   (g_param_spec_types[4])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecUInt"><type>GParamSpecUInt</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecUInt" role="struct">
<title>struct GParamSpecUInt</title>
<indexterm zone="GParamSpecUInt"><primary sortas="ParamSpecUInt">GParamSpecUInt</primary></indexterm>
<programlisting language="C">struct GParamSpecUInt {
  GParamSpec    parent_instance;

  guint         minimum;
  guint         maximum;
  guint         default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for unsigned integer properties.</para>
<refsect3 id="GParamSpecUInt.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GParamSpecUInt.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GParamSpecUInt.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GParamSpecUInt.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-LONG:CAPS" role="macro">
<title>G_TYPE_PARAM_LONG</title>
<indexterm zone="G-TYPE-PARAM-LONG:CAPS"><primary sortas="TYPE_PARAM_LONG">G_TYPE_PARAM_LONG</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_LONG		   (g_param_spec_types[5])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecLong"><type>GParamSpecLong</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecLong" role="struct">
<title>struct GParamSpecLong</title>
<indexterm zone="GParamSpecLong"><primary sortas="ParamSpecLong">GParamSpecLong</primary></indexterm>
<programlisting language="C">struct GParamSpecLong {
  GParamSpec    parent_instance;

  glong         minimum;
  glong         maximum;
  glong         default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for long integer properties.</para>
<refsect3 id="GParamSpecLong.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="glong"><type>glong</type></link>&#160;<structfield id="GParamSpecLong.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="glong"><type>glong</type></link>&#160;<structfield id="GParamSpecLong.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="glong"><type>glong</type></link>&#160;<structfield id="GParamSpecLong.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-ULONG:CAPS" role="macro">
<title>G_TYPE_PARAM_ULONG</title>
<indexterm zone="G-TYPE-PARAM-ULONG:CAPS"><primary sortas="TYPE_PARAM_ULONG">G_TYPE_PARAM_ULONG</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_ULONG		   (g_param_spec_types[6])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecULong"><type>GParamSpecULong</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecULong" role="struct">
<title>struct GParamSpecULong</title>
<indexterm zone="GParamSpecULong"><primary sortas="ParamSpecULong">GParamSpecULong</primary></indexterm>
<programlisting language="C">struct GParamSpecULong {
  GParamSpec    parent_instance;

  gulong        minimum;
  gulong        maximum;
  gulong        default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for unsigned long integer properties.</para>
<refsect3 id="GParamSpecULong.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gulong"><type>gulong</type></link>&#160;<structfield id="GParamSpecULong.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gulong"><type>gulong</type></link>&#160;<structfield id="GParamSpecULong.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gulong"><type>gulong</type></link>&#160;<structfield id="GParamSpecULong.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-INT64:CAPS" role="macro">
<title>G_TYPE_PARAM_INT64</title>
<indexterm zone="G-TYPE-PARAM-INT64:CAPS"><primary sortas="TYPE_PARAM_INT64">G_TYPE_PARAM_INT64</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_INT64		   (g_param_spec_types[7])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecInt64"><type>GParamSpecInt64</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecInt64" role="struct">
<title>struct GParamSpecInt64</title>
<indexterm zone="GParamSpecInt64"><primary sortas="ParamSpecInt64">GParamSpecInt64</primary></indexterm>
<programlisting language="C">struct GParamSpecInt64 {
  GParamSpec    parent_instance;

  gint64        minimum;
  gint64        maximum;
  gint64        default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for 64bit integer properties.</para>
<refsect3 id="GParamSpecInt64.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint64"><type>gint64</type></link>&#160;<structfield id="GParamSpecInt64.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint64"><type>gint64</type></link>&#160;<structfield id="GParamSpecInt64.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint64"><type>gint64</type></link>&#160;<structfield id="GParamSpecInt64.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-UINT64:CAPS" role="macro">
<title>G_TYPE_PARAM_UINT64</title>
<indexterm zone="G-TYPE-PARAM-UINT64:CAPS"><primary sortas="TYPE_PARAM_UINT64">G_TYPE_PARAM_UINT64</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_UINT64		   (g_param_spec_types[8])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecUInt64"><type>GParamSpecUInt64</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecUInt64" role="struct">
<title>struct GParamSpecUInt64</title>
<indexterm zone="GParamSpecUInt64"><primary sortas="ParamSpecUInt64">GParamSpecUInt64</primary></indexterm>
<programlisting language="C">struct GParamSpecUInt64 {
  GParamSpec    parent_instance;

  guint64       minimum;
  guint64       maximum;
  guint64       default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for unsigned 64bit integer properties.</para>
<refsect3 id="GParamSpecUInt64.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint64"><type>guint64</type></link>&#160;<structfield id="GParamSpecUInt64.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint64"><type>guint64</type></link>&#160;<structfield id="GParamSpecUInt64.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint64"><type>guint64</type></link>&#160;<structfield id="GParamSpecUInt64.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-FLOAT:CAPS" role="macro">
<title>G_TYPE_PARAM_FLOAT</title>
<indexterm zone="G-TYPE-PARAM-FLOAT:CAPS"><primary sortas="TYPE_PARAM_FLOAT">G_TYPE_PARAM_FLOAT</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_FLOAT		   (g_param_spec_types[12])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecFloat"><type>GParamSpecFloat</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecFloat" role="struct">
<title>struct GParamSpecFloat</title>
<indexterm zone="GParamSpecFloat"><primary sortas="ParamSpecFloat">GParamSpecFloat</primary></indexterm>
<programlisting language="C">struct GParamSpecFloat {
  GParamSpec    parent_instance;

  gfloat        minimum;
  gfloat        maximum;
  gfloat        default_value;
  gfloat        epsilon;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for float properties.</para>
<refsect3 id="GParamSpecFloat.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gfloat"><type>gfloat</type></link>&#160;<structfield id="GParamSpecFloat.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gfloat"><type>gfloat</type></link>&#160;<structfield id="GParamSpecFloat.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gfloat"><type>gfloat</type></link>&#160;<structfield id="GParamSpecFloat.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gfloat"><type>gfloat</type></link>&#160;<structfield id="GParamSpecFloat.epsilon">epsilon</structfield>;</para></entry>
<entry role="struct_member_description"><para>values closer than <parameter>epsilon</parameter>
will be considered identical
by <link linkend="g-param-values-cmp"><function>g_param_values_cmp()</function></link>; the default value is 1e-30.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-DOUBLE:CAPS" role="macro">
<title>G_TYPE_PARAM_DOUBLE</title>
<indexterm zone="G-TYPE-PARAM-DOUBLE:CAPS"><primary sortas="TYPE_PARAM_DOUBLE">G_TYPE_PARAM_DOUBLE</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_DOUBLE		   (g_param_spec_types[13])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecDouble"><type>GParamSpecDouble</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecDouble" role="struct">
<title>struct GParamSpecDouble</title>
<indexterm zone="GParamSpecDouble"><primary sortas="ParamSpecDouble">GParamSpecDouble</primary></indexterm>
<programlisting language="C">struct GParamSpecDouble {
  GParamSpec    parent_instance;

  gdouble       minimum;
  gdouble       maximum;
  gdouble       default_value;
  gdouble       epsilon;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for double properties.</para>
<refsect3 id="GParamSpecDouble.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gdouble"><type>gdouble</type></link>&#160;<structfield id="GParamSpecDouble.minimum">minimum</structfield>;</para></entry>
<entry role="struct_member_description"><para>minimum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gdouble"><type>gdouble</type></link>&#160;<structfield id="GParamSpecDouble.maximum">maximum</structfield>;</para></entry>
<entry role="struct_member_description"><para>maximum value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gdouble"><type>gdouble</type></link>&#160;<structfield id="GParamSpecDouble.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gdouble"><type>gdouble</type></link>&#160;<structfield id="GParamSpecDouble.epsilon">epsilon</structfield>;</para></entry>
<entry role="struct_member_description"><para>values closer than <parameter>epsilon</parameter>
will be considered identical
by <link linkend="g-param-values-cmp"><function>g_param_values_cmp()</function></link>; the default value is 1e-90.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-ENUM:CAPS" role="macro">
<title>G_TYPE_PARAM_ENUM</title>
<indexterm zone="G-TYPE-PARAM-ENUM:CAPS"><primary sortas="TYPE_PARAM_ENUM">G_TYPE_PARAM_ENUM</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_ENUM		   (g_param_spec_types[10])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecEnum"><type>GParamSpecEnum</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecEnum" role="struct">
<title>struct GParamSpecEnum</title>
<indexterm zone="GParamSpecEnum"><primary sortas="ParamSpecEnum">GParamSpecEnum</primary></indexterm>
<programlisting language="C">struct GParamSpecEnum {
  GParamSpec    parent_instance;

  GEnumClass   *enum_class;
  gint          default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for enum

properties.</para>
<refsect3 id="GParamSpecEnum.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="GEnumClass"><type>GEnumClass</type></link>&#160;*<structfield id="GParamSpecEnum.enum-class">enum_class</structfield>;</para></entry>
<entry role="struct_member_description"><para>the <link linkend="GEnumClass"><type>GEnumClass</type></link> for the enum</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gint"><type>gint</type></link>&#160;<structfield id="GParamSpecEnum.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-FLAGS:CAPS" role="macro">
<title>G_TYPE_PARAM_FLAGS</title>
<indexterm zone="G-TYPE-PARAM-FLAGS:CAPS"><primary sortas="TYPE_PARAM_FLAGS">G_TYPE_PARAM_FLAGS</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_FLAGS		   (g_param_spec_types[11])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecFlags"><type>GParamSpecFlags</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecFlags" role="struct">
<title>struct GParamSpecFlags</title>
<indexterm zone="GParamSpecFlags"><primary sortas="ParamSpecFlags">GParamSpecFlags</primary></indexterm>
<programlisting language="C">struct GParamSpecFlags {
  GParamSpec    parent_instance;

  GFlagsClass  *flags_class;
  guint         default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for flags
properties.</para>
<refsect3 id="GParamSpecFlags.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="GFlagsClass"><type>GFlagsClass</type></link>&#160;*<structfield id="GParamSpecFlags.flags-class">flags_class</structfield>;</para></entry>
<entry role="struct_member_description"><para>the <link linkend="GFlagsClass"><type>GFlagsClass</type></link> for the flags</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GParamSpecFlags.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-STRING:CAPS" role="macro">
<title>G_TYPE_PARAM_STRING</title>
<indexterm zone="G-TYPE-PARAM-STRING:CAPS"><primary sortas="TYPE_PARAM_STRING">G_TYPE_PARAM_STRING</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_STRING		   (g_param_spec_types[14])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecString"><type>GParamSpecString</type></link>.</para>
</refsect2>
<refsect2 id="G-VALUE-INTERNED-STRING:CAPS" role="macro" condition="since:2.66">
<title>G_VALUE_INTERNED_STRING</title>
<indexterm zone="G-VALUE-INTERNED-STRING:CAPS" role="2.66"><primary sortas="VALUE_INTERNED_STRING">G_VALUE_INTERNED_STRING</primary></indexterm>
<programlisting language="C">#define G_VALUE_INTERNED_STRING (1 &lt;&lt; 28) GLIB_AVAILABLE_MACRO_IN_2_66
</programlisting>
<para>For string values, indicates that the string contained is canonical and will
exist for the duration of the process. See <link linkend="g-value-set-interned-string"><function>g_value_set_interned_string()</function></link>.</para>
<para role="since">Since: <link linkend="api-index-2.66">2.66</link></para></refsect2>
<refsect2 id="GParamSpecString" role="struct">
<title>struct GParamSpecString</title>
<indexterm zone="GParamSpecString"><primary sortas="ParamSpecString">GParamSpecString</primary></indexterm>
<programlisting language="C">struct GParamSpecString {
  GParamSpec    parent_instance;

  gchar        *default_value;
  gchar        *cset_first;
  gchar        *cset_nth;
  gchar         substitutor;
  guint         null_fold_if_empty : 1;
  guint         ensure_non_null : 1;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for string
properties.</para>
<refsect3 id="GParamSpecString.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gchar"><type>gchar</type></link>&#160;*<structfield id="GParamSpecString.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gchar"><type>gchar</type></link>&#160;*<structfield id="GParamSpecString.cset-first">cset_first</structfield>;</para></entry>
<entry role="struct_member_description"><para>a string containing the allowed values for the first byte</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gchar"><type>gchar</type></link>&#160;*<structfield id="GParamSpecString.cset-nth">cset_nth</structfield>;</para></entry>
<entry role="struct_member_description"><para>a string containing the allowed values for the subsequent bytes</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="gchar"><type>gchar</type></link>&#160;<structfield id="GParamSpecString.substitutor">substitutor</structfield>;</para></entry>
<entry role="struct_member_description"><para>the replacement byte for bytes which don't match <parameter>cset_first</parameter>
or <parameter>cset_nth</parameter>
.</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GParamSpecString.null-fold-if-empty">null_fold_if_empty</structfield>&#160;:&#160;1;</para></entry>
<entry role="struct_member_description"><para>replace empty string by <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GParamSpecString.ensure-non-null">ensure_non_null</structfield>&#160;:&#160;1;</para></entry>
<entry role="struct_member_description"><para>replace <link linkend="NULL:CAPS"><literal>NULL</literal></link> strings by an empty string</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="gchararray" role="typedef">
<title>gchararray</title>
<indexterm zone="gchararray"><primary sortas="chararray">gchararray</primary></indexterm>
<programlisting language="C">typedef gchar* gchararray;
</programlisting>
<para>A C representable type name for <link linkend="G-TYPE-STRING:CAPS"><type>G_TYPE_STRING</type></link>.</para>
</refsect2>
<refsect2 id="G-TYPE-PARAM-PARAM:CAPS" role="macro">
<title>G_TYPE_PARAM_PARAM</title>
<indexterm zone="G-TYPE-PARAM-PARAM:CAPS"><primary sortas="TYPE_PARAM_PARAM">G_TYPE_PARAM_PARAM</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_PARAM		   (g_param_spec_types[15])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecParam"><type>GParamSpecParam</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecParam" role="struct">
<title>struct GParamSpecParam</title>
<indexterm zone="GParamSpecParam"><primary sortas="ParamSpecParam">GParamSpecParam</primary></indexterm>
<programlisting language="C">struct GParamSpecParam {
  GParamSpec    parent_instance;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for <link linkend="G-TYPE-PARAM:CAPS"><literal>G_TYPE_PARAM</literal></link>
properties.</para>
<refsect3 id="GParamSpecParam.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-BOXED:CAPS" role="macro">
<title>G_TYPE_PARAM_BOXED</title>
<indexterm zone="G-TYPE-PARAM-BOXED:CAPS"><primary sortas="TYPE_PARAM_BOXED">G_TYPE_PARAM_BOXED</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_BOXED		   (g_param_spec_types[16])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecBoxed"><type>GParamSpecBoxed</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecBoxed" role="struct">
<title>struct GParamSpecBoxed</title>
<indexterm zone="GParamSpecBoxed"><primary sortas="ParamSpecBoxed">GParamSpecBoxed</primary></indexterm>
<programlisting language="C">struct GParamSpecBoxed {
  GParamSpec    parent_instance;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for boxed properties.</para>
<refsect3 id="GParamSpecBoxed.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-POINTER:CAPS" role="macro">
<title>G_TYPE_PARAM_POINTER</title>
<indexterm zone="G-TYPE-PARAM-POINTER:CAPS"><primary sortas="TYPE_PARAM_POINTER">G_TYPE_PARAM_POINTER</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_POINTER		   (g_param_spec_types[17])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecPointer"><type>GParamSpecPointer</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecPointer" role="struct">
<title>struct GParamSpecPointer</title>
<indexterm zone="GParamSpecPointer"><primary sortas="ParamSpecPointer">GParamSpecPointer</primary></indexterm>
<programlisting language="C">struct GParamSpecPointer {
  GParamSpec    parent_instance;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for pointer properties.</para>
<refsect3 id="GParamSpecPointer.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-OBJECT:CAPS" role="macro">
<title>G_TYPE_PARAM_OBJECT</title>
<indexterm zone="G-TYPE-PARAM-OBJECT:CAPS"><primary sortas="TYPE_PARAM_OBJECT">G_TYPE_PARAM_OBJECT</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_OBJECT		   (g_param_spec_types[19])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecObject"><type>GParamSpecObject</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecObject" role="struct">
<title>struct GParamSpecObject</title>
<indexterm zone="GParamSpecObject"><primary sortas="ParamSpecObject">GParamSpecObject</primary></indexterm>
<programlisting language="C">struct GParamSpecObject {
  GParamSpec    parent_instance;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for object properties.</para>
<refsect3 id="GParamSpecObject.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-UNICHAR:CAPS" role="macro">
<title>G_TYPE_PARAM_UNICHAR</title>
<indexterm zone="G-TYPE-PARAM-UNICHAR:CAPS"><primary sortas="TYPE_PARAM_UNICHAR">G_TYPE_PARAM_UNICHAR</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_UNICHAR		   (g_param_spec_types[9])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecUnichar"><type>GParamSpecUnichar</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecUnichar" role="struct">
<title>struct GParamSpecUnichar</title>
<indexterm zone="GParamSpecUnichar"><primary sortas="ParamSpecUnichar">GParamSpecUnichar</primary></indexterm>
<programlisting language="C">struct GParamSpecUnichar {
  GParamSpec    parent_instance;

  gunichar      default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for unichar (unsigned integer) properties.</para>
<refsect3 id="GParamSpecUnichar.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="gunichar"><type>gunichar</type></link>&#160;<structfield id="GParamSpecUnichar.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>default value for the property specified</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-VALUE-ARRAY:CAPS" role="macro" condition="deprecated:2.32: Use #GArray instead of #GValueArray">
<title>G_TYPE_PARAM_VALUE_ARRAY</title>
<indexterm zone="G-TYPE-PARAM-VALUE-ARRAY:CAPS" role="deprecated"><primary sortas="TYPE_PARAM_VALUE_ARRAY">G_TYPE_PARAM_VALUE_ARRAY</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_VALUE_ARRAY	   (g_param_spec_types[18]) GLIB_DEPRECATED_MACRO_IN_2_32
</programlisting>
<warning><para><literal>G_TYPE_PARAM_VALUE_ARRAY</literal> has been deprecated since version 2.32 and should not be used in newly-written code.</para> <para>Use <link linkend="GArray"><type>GArray</type></link> instead of <link linkend="GValueArray"><type>GValueArray</type></link></para>
</warning>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecValueArray"><type>GParamSpecValueArray</type></link>.</para>
</refsect2>
<refsect2 id="GParamSpecValueArray" role="struct">
<title>struct GParamSpecValueArray</title>
<indexterm zone="GParamSpecValueArray"><primary sortas="ParamSpecValueArray">GParamSpecValueArray</primary></indexterm>
<programlisting language="C">struct GParamSpecValueArray {
  GParamSpec    parent_instance;
  GParamSpec   *element_spec;
  guint		fixed_n_elements;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for <link linkend="GValueArray"><type>GValueArray</type></link> properties.</para>
<refsect3 id="GParamSpecValueArray.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="GParamSpec"><type>GParamSpec</type></link>&#160;*<structfield id="GParamSpecValueArray.element-spec">element_spec</structfield>;</para></entry>
<entry role="struct_member_description"><para>a <link linkend="GParamSpec"><type>GParamSpec</type></link> describing the elements contained in arrays of this property, may be <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="guint"><type>guint</type></link>&#160;<structfield id="GParamSpecValueArray.fixed-n-elements">fixed_n_elements</structfield>;</para></entry>
<entry role="struct_member_description"><para>if greater than 0, arrays of this property will always have this many elements</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>
<refsect2 id="G-TYPE-PARAM-OVERRIDE:CAPS" role="macro" condition="since:2.4">
<title>G_TYPE_PARAM_OVERRIDE</title>
<indexterm zone="G-TYPE-PARAM-OVERRIDE:CAPS" role="2.4"><primary sortas="TYPE_PARAM_OVERRIDE">G_TYPE_PARAM_OVERRIDE</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_OVERRIDE		   (g_param_spec_types[20])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecOverride"><type>GParamSpecOverride</type></link>.</para>
<para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="GParamSpecOverride" role="struct" condition="since:2.4">
<title>struct GParamSpecOverride</title>
<indexterm zone="GParamSpecOverride" role="2.4"><primary sortas="ParamSpecOverride">GParamSpecOverride</primary></indexterm>
<programlisting language="C">struct GParamSpecOverride {
};
</programlisting>
<para>This is a type of <link linkend="GParamSpec"><type>GParamSpec</type></link> type that simply redirects operations to
another paramspec.  All operations other than getting or
setting the value are redirected, including accessing the nick and
blurb, validating a value, and so forth. See
<link linkend="g-param-spec-get-redirect-target"><function>g_param_spec_get_redirect_target()</function></link> for retrieving the overridden
property. <link linkend="GParamSpecOverride"><type>GParamSpecOverride</type></link> is used in implementing
<link linkend="g-object-class-override-property"><function>g_object_class_override_property()</function></link>, and will not be directly useful
unless you are implementing a new base type similar to GObject.</para>
<para role="since">Since: <link linkend="api-index-2.4">2.4</link></para></refsect2>
<refsect2 id="G-TYPE-PARAM-GTYPE:CAPS" role="macro" condition="since:2.10">
<title>G_TYPE_PARAM_GTYPE</title>
<indexterm zone="G-TYPE-PARAM-GTYPE:CAPS" role="2.10"><primary sortas="TYPE_PARAM_GTYPE">G_TYPE_PARAM_GTYPE</primary></indexterm>
<programlisting language="C">#define&#160;G_TYPE_PARAM_GTYPE		   (g_param_spec_types[21])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecGType"><type>GParamSpecGType</type></link>.</para>
<para role="since">Since: <link linkend="api-index-2.10">2.10</link></para></refsect2>
<refsect2 id="GParamSpecGType" role="struct" condition="since:2.10">
<title>struct GParamSpecGType</title>
<indexterm zone="GParamSpecGType" role="2.10"><primary sortas="ParamSpecGType">GParamSpecGType</primary></indexterm>
<programlisting language="C">struct GParamSpecGType {
  GParamSpec    parent_instance;
  GType         is_a_type;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for <link linkend="GType"><type>GType</type></link> properties.</para>
<refsect3 id="GParamSpecGType.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="GType"><type>GType</type></link>&#160;<structfield id="GParamSpecGType.is-a-type">is_a_type</structfield>;</para></entry>
<entry role="struct_member_description"><para>a <link linkend="GType"><type>GType</type></link> whose subtypes can occur as values</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
<para role="since">Since: <link linkend="api-index-2.10">2.10</link></para></refsect2>
<refsect2 id="G-TYPE-PARAM-VARIANT:CAPS" role="macro" condition="since:2.26">
<title>G_TYPE_PARAM_VARIANT</title>
<indexterm zone="G-TYPE-PARAM-VARIANT:CAPS" role="2.26"><primary sortas="TYPE_PARAM_VARIANT">G_TYPE_PARAM_VARIANT</primary></indexterm>
<programlisting language="C">#define G_TYPE_PARAM_VARIANT                (g_param_spec_types[22])
</programlisting>
<para>The <link linkend="GType"><type>GType</type></link> of <link linkend="GParamSpecVariant"><type>GParamSpecVariant</type></link>.</para>
<para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>
<refsect2 id="GParamSpecVariant" role="struct" condition="since:2.26">
<title>struct GParamSpecVariant</title>
<indexterm zone="GParamSpecVariant" role="2.26"><primary sortas="ParamSpecVariant">GParamSpecVariant</primary></indexterm>
<programlisting language="C">struct GParamSpecVariant {
  GParamSpec    parent_instance;
  GVariantType *type;
  GVariant     *default_value;
};
</programlisting>
<para>A <link linkend="GParamSpec"><type>GParamSpec</type></link> derived structure that contains the meta data for <link linkend="GVariant"><type>GVariant</type></link> properties.</para>
<para>When comparing values with <link linkend="g-param-values-cmp"><function>g_param_values_cmp()</function></link>, scalar values with the same
type will be compared with <link linkend="g-variant-compare"><function>g_variant_compare()</function></link>. Other non-<link linkend="NULL:CAPS"><literal>NULL</literal></link> variants will
be checked for equality with <link linkend="g-variant-equal"><function>g_variant_equal()</function></link>, and their sort order is
otherwise undefined. <link linkend="NULL:CAPS"><literal>NULL</literal></link> is ordered before non-<link linkend="NULL:CAPS"><literal>NULL</literal></link> variants. Two <link linkend="NULL:CAPS"><literal>NULL</literal></link>
values compare equal.</para>
<refsect3 id="GParamSpecVariant.members" role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row role="member"><entry role="struct_member_name"><para><link linkend="GVariantType"><type>GVariantType</type></link>&#160;*<structfield id="GParamSpecVariant.type">type</structfield>;</para></entry>
<entry role="struct_member_description"><para>a <link linkend="GVariantType"><type>GVariantType</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="struct_member_annotations"></entry>
</row>
<row role="member"><entry role="struct_member_name"><para><link linkend="GVariant"><type>GVariant</type></link>&#160;*<structfield id="GParamSpecVariant.default-value">default_value</structfield>;</para></entry>
<entry role="struct_member_description"><para>a <link linkend="GVariant"><type>GVariant</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
<para role="since">Since: <link linkend="api-index-2.26">2.26</link></para></refsect2>

</refsect1>
<refsect1 id="gobject-Standard-Parameter-and-Value-Types.see-also">
<title>See Also</title>
<para><link linkend="GParamSpec"><type>GParamSpec</type></link>, <link linkend="GValue"><type>GValue</type></link>, <link linkend="g-object-class-install-property"><function>g_object_class_install_property()</function></link>.</para>

</refsect1>

</refentry>
