<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="cutter-Convenience-test-data-API">
<refmeta>
<refentrytitle role="top_of_page" id="cutter-Convenience-test-data-API.top_of_page"
>Convenience test data API</refentrytitle>
<manvolnum
>3</manvolnum>
<refmiscinfo
>Cutterライブラリ</refmiscinfo>
</refmeta>
<refnamediv>
<refname
>Convenience test data API</refname>
<refpurpose
>構造体定義なしでテストデータを作成するためのAPI。</refpurpose>
</refnamediv>

<refsect1 id="cutter-Convenience-test-data-API.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="function_type"
><link linkend="void"
><returnvalue
>void</returnvalue
></link>
</entry
><entry role="function_name"
><link linkend="gcut-add-datum"
>gcut_add_datum</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="gcut-data-has-field"
>gcut_data_has_field</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-data-get-char"
>gcut_data_get_char</link
><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="gcut-data-get-string"
>gcut_data_get_string</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="gcut-data-get-int"
>gcut_data_get_int</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="gcut-data-get-uint"
>gcut_data_get_uint</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-data-get-int64"
>gcut_data_get_int64</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-data-get-uint64"
>gcut_data_get_uint64</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-data-get-size"
>gcut_data_get_size</link
><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="gcut-data-get-flags"
>gcut_data_get_flags</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="gcut-data-get-enum"
>gcut_data_get_enum</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="gconstpointer"
><returnvalue
>gconstpointer</returnvalue
></link>
</entry
><entry role="function_name"
><link linkend="gcut-data-get-pointer"
>gcut_data_get_pointer</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="gconstpointer"
><returnvalue
>gconstpointer</returnvalue
></link>
</entry
><entry role="function_name"
><link linkend="gcut-data-get-boxed"
>gcut_data_get_boxed</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-data-get-object"
>gcut_data_get_object</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-data-get-boolean"
>gcut_data_get_boolean</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-data-get-double"
>gcut_data_get_double</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>

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


<refsect1 id="cutter-Convenience-test-data-API.description" role="desc">
<title role="desc.title"
>説明</title>
<para
><link linkend="cut-add-data"
><function
>cut_add_data()</function
></link
>で複雑なテストデータを使用したい場合はテストデータ用にデータ型を定義する必要があります。しかし、それは少し面倒です。<link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>はデータ型を定義せずに複雑なテストデータを使用するためのAPIを提供します。このAPIは複雑なデータを扱うために<link linkend="GType"
><type
>GType</type
></link
>を使います。</para>

</refsect1>
<refsect1 id="cutter-Convenience-test-data-API.functions_details" role="details">
<title role="details.title"
>Functions</title>
<refsect2 id="gcut-add-datum" role="function" condition="since:1.0.6">
<title
>gcut_add_datum&#160;()</title>
<indexterm zone="gcut-add-datum" role="1.0.6"
><primary
>gcut_add_datum</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
gcut_add_datum (<parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                <parameter>const <link linkend="gchar"><type>gchar</type></link> *first_field_name</parameter>,
                <parameter>...</parameter>);</programlisting>
<para
>データ駆動テスト用のデータを追加します。複雑なテストデータのために新しく構造体を定義する必要がないため、<link linkend="cut-add-data"
><function
>cut_add_data()</function
></link
>よりも便利です。</para>
<para
>例:</para>
<informalexample
><programlisting role="example"
><![CDATA[
#include <gcutter.h>

void data_translate (void);
void test_translate (gconstpointer data);

static const gchar*
translate (gint input)
{
   switch(input) {
   case 1:
       return "first";
   case 111:
       return "a hundred eleven";
   default:
       return "unsupported";
   }
}

void
data_translate(void)
{
    gcut_add_datum("simple data",
                   "translated", G_TYPE_STRING, "first",
                   "input", G_TYPE_INT, 1,
                   NULL);
    gcut_add_datum("complex data",
                   "translated", G_TYPE_STRING, "a hundred eleven",
                   "input", G_TYPE_INT, 111,
                   NULL);
}

void
test_translate(gconstpointer data)
{
    cut_assert_equal_string(gcut_data_get_string(data, "translated"),
                            translate(gcut_data_get_int(data, "input")));
}
]]></programlisting
></informalexample>
<para
></para>
<para
>利用可能な型とその時の値は以下の通りです。</para>
<variablelist>
  <varlistentry>
    <term
><link linkend="G-TYPE-CHAR:CAPS"
><type
>G_TYPE_CHAR</type
></link
></term>
    <listitem>
      <para
><link linkend="gchar"
><type
>gchar</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_CHAR, 'X',
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-STRING:CAPS"
><type
>G_TYPE_STRING</type
></link
></term>
    <listitem>
      <para
>const <link linkend="gchar"
><type
>gchar</type
></link
> *value</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_STRING, "string value",
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-INT:CAPS"
><type
>G_TYPE_INT</type
></link
></term>
    <listitem>
      <para
><link linkend="gint"
><type
>gint</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_INT, 100,
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-UINT:CAPS"
><type
>G_TYPE_UINT</type
></link
></term>
    <listitem>
      <para
><link linkend="guint"
><type
>guint</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_UINT, 100,
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-INT64:CAPS"
><type
>G_TYPE_INT64</type
></link
></term>
    <listitem>
      <para
><link linkend="gint64"
><type
>gint64</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_INT64, G_GINT64_CONSTANT(100),
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-UINT64:CAPS"
><type
>G_TYPE_UINT64</type
></link
></term>
    <listitem>
      <para
><link linkend="guint64"
><type
>guint64</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_UINT64, G_GUINT64_CONSTANT(100),
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-GTYPE:CAPS"
><type
>G_TYPE_GTYPE</type
></link
></term>
    <listitem>
      <para
><link linkend="GType"
><type
>GType</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_GTYPE, G_TYPE_OBJECT,
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>GFlagsの型</term>
    <listitem>
      <para
>その型の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", GTK_TYPE_WIDGET_FLAGS, GTK_TOPLEVEL | GTK_MAPPED,
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>GEnumの型</term>
    <listitem>
      <para
>その型の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", GTK_TYPE_WRAP_MODE, GTK_WRAP_NONE,
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-POINTER:CAPS"
><type
>G_TYPE_POINTER</type
></link
></term>
    <listitem>
      <para
><link linkend="gconstpointer"
><type
>gconstpointer</type
></link
> value, <link linkend="GDestroyNotify"
><type
>GDestroyNotify</type
></link
> notify</para>
      <para
>valueが破棄されるときにnotifyが呼ばれます。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_POINTER, my_structure_new(...), my_structure_free,
               NULL);
]]></programlisting
></informalexample>
      </para>
      <para
>注意: 値の所有者はCutterになります。解放しないで下さい。</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>GBoxedの型</term>
    <listitem>
      <para
>その型の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_HASH_TABLE,
               gcut_hash_table_string_string_new("name1", "value1",
                                                 "name2", "value2",
                                                 NULL),
               NULL);
]]></programlisting
></informalexample>
      </para>
      <para
>注意: 値の所有者はCutterになります。解放しないで下さい。</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-BOOLEAN:CAPS"
><type
>G_TYPE_BOOLEAN</type
></link
></term>
    <listitem>
      <para
><link linkend="gboolean"
><type
>gboolean</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_BOOLEAN, TRUE,
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><link linkend="G-TYPE-DOUBLE:CAPS"
><type
>G_TYPE_DOUBLE</type
></link
></term>
    <listitem>
      <para
><link linkend="gdouble"
><type
>gdouble</type
></link
>の値。</para>
      <para
>例: <informalexample
><programlisting role="example"
><![CDATA[
gcut_add_datum("data name",
               "field-name", G_TYPE_DOUBLE, 2.9,
               NULL);
]]></programlisting
></informalexample>
      </para>
    </listitem>
  </varlistentry>
</variablelist>
<refsect3 id="gcut-add-datum.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
>データの名前。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>最初のフィールド名。</para
></entry>
<entry role="parameter_description"
><para
>最初のフィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>...</para
></entry>
<entry role="parameter_description"
><para
>最初のフィールドの型と値。その後に、フィールドの名前と型と値の3つを任意の数だけ指定します。最後の引数は<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>にしてください。詳細は関数の説明文のところにあります。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-data-has-field" role="function" condition="since:1.1.5">
<title
>gcut_data_has_field&#160;()</title>
<indexterm zone="gcut-data-has-field" role="1.1.5"
><primary
>gcut_data_has_field</primary
></indexterm>
<programlisting language="C"
><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_data_has_field (<parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> data</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *field_name</parameter>);</programlisting>
<refsect3 id="gcut-data-has-field.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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-has-field.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>data</parameter
>に<parameter
>field_name</parameter
>フィールドがあれば<link linkend="TRUE:CAPS"
><literal
>TRUE</literal
></link
>、そうでなければ<link linkend="FALSE:CAPS"
><literal
>FALSE</literal
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-data-get-char" role="macro" condition="since:1.1.3">
<title
>gcut_data_get_char()</title>
<indexterm zone="gcut-data-get-char" role="1.1.3"
><primary
>gcut_data_get_char</primary
></indexterm>
<programlisting language="C"
>#define             gcut_data_get_char(data, field_name)</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値を文字として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-char.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.3"
>1.1.3</link
></para
></refsect2>
<refsect2 id="gcut-data-get-string" role="function" condition="since:1.0.6">
<title
>gcut_data_get_string&#160;()</title>
<indexterm zone="gcut-data-get-string" role="1.0.6"
><primary
>gcut_data_get_string</primary
></indexterm>
<programlisting language="C"
>const <link linkend="gchar"
><returnvalue
>gchar</returnvalue
></link
>&#160;*
gcut_data_get_string (<parameter
><link linkend="gconstpointer"
><type
>gconstpointer</type
></link
> data</parameter
>,
                      <parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *field_name</parameter
>);</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値を文字列として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-string.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-data-get-int" role="function" condition="since:1.0.6">
<title
>gcut_data_get_int&#160;()</title>
<indexterm zone="gcut-data-get-int" role="1.0.6"
><primary
>gcut_data_get_int</primary
></indexterm>
<programlisting language="C"
><link linkend="gint"><returnvalue>gint</returnvalue></link>
gcut_data_get_int (<parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> data</parameter>,
                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *field_name</parameter>);</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値を整数として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-int.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-data-get-uint" role="function" condition="since:1.0.6">
<title
>gcut_data_get_uint&#160;()</title>
<indexterm zone="gcut-data-get-uint" role="1.0.6"
><primary
>gcut_data_get_uint</primary
></indexterm>
<programlisting language="C"
><link linkend="guint"><returnvalue>guint</returnvalue></link>
gcut_data_get_uint (<parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> data</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *field_name</parameter>);</programlisting>
<para
><parameter
>field_name</parameter
>の値を符号なし整数として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-uint.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-data-get-int64" role="macro" condition="since:1.1.3">
<title
>gcut_data_get_int64()</title>
<indexterm zone="gcut-data-get-int64" role="1.1.3"
><primary
>gcut_data_get_int64</primary
></indexterm>
<programlisting language="C"
>#define             gcut_data_get_int64(data, field_name)</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値を64bit整数として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-int64.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.3"
>1.1.3</link
></para
></refsect2>
<refsect2 id="gcut-data-get-uint64" role="macro" condition="since:1.1.3">
<title
>gcut_data_get_uint64()</title>
<indexterm zone="gcut-data-get-uint64" role="1.1.3"
><primary
>gcut_data_get_uint64</primary
></indexterm>
<programlisting language="C"
>#define             gcut_data_get_uint64(data, field_name)</programlisting>
<para
><parameter
>field_name</parameter
>の値を64bit符号なし整数として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-uint64.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.3"
>1.1.3</link
></para
></refsect2>
<refsect2 id="gcut-data-get-size" role="macro" condition="since:1.1.3">
<title
>gcut_data_get_size()</title>
<indexterm zone="gcut-data-get-size" role="1.1.3"
><primary
>gcut_data_get_size</primary
></indexterm>
<programlisting language="C"
>#define             gcut_data_get_size(data, field_name)</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値をsize_tとして取得します。</para>
<refsect3 id="gcut-data-get-size.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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-size.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.3"
>1.1.3</link
></para
></refsect2>
<refsect2 id="gcut-data-get-flags" role="function" condition="since:1.0.6">
<title
>gcut_data_get_flags&#160;()</title>
<indexterm zone="gcut-data-get-flags" role="1.0.6"
><primary
>gcut_data_get_flags</primary
></indexterm>
<programlisting language="C"
><link linkend="guint"><returnvalue>guint</returnvalue></link>
gcut_data_get_flags (<parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> data</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *field_name</parameter>);</programlisting>
<para
><parameter
>field_name</parameter
>の値をGFlags型の符号なし整数として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-flags.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-data-get-enum" role="function" condition="since:1.0.6">
<title
>gcut_data_get_enum&#160;()</title>
<indexterm zone="gcut-data-get-enum" role="1.0.6"
><primary
>gcut_data_get_enum</primary
></indexterm>
<programlisting language="C"
><link linkend="gint"><returnvalue>gint</returnvalue></link>
gcut_data_get_enum (<parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> data</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *field_name</parameter>);</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値をGEnum型の整数として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-enum.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-data-get-pointer" role="function" condition="since:1.0.6">
<title
>gcut_data_get_pointer&#160;()</title>
<indexterm zone="gcut-data-get-pointer" role="1.0.6"
><primary
>gcut_data_get_pointer</primary
></indexterm>
<programlisting language="C"
><link linkend="gconstpointer"><returnvalue>gconstpointer</returnvalue></link>
gcut_data_get_pointer (<parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> data</parameter>,
                       <parameter>const <link linkend="gchar"><type>gchar</type></link> *field_name</parameter>);</programlisting>
<para
><parameter
>field_name</parameter
>の値をポインタとして取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-pointer.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-data-get-boxed" role="function" condition="since:1.0.7">
<title
>gcut_data_get_boxed&#160;()</title>
<indexterm zone="gcut-data-get-boxed" role="1.0.7"
><primary
>gcut_data_get_boxed</primary
></indexterm>
<programlisting language="C"
><link linkend="gconstpointer"><returnvalue>gconstpointer</returnvalue></link>
gcut_data_get_boxed (<parameter><link linkend="gconstpointer"><type>gconstpointer</type></link> data</parameter>,
                     <parameter>const <link linkend="gchar"><type>gchar</type></link> *field_name</parameter>);</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値をGBoxed型の値として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-boxed.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.7"
>1.0.7</link
></para
></refsect2>
<refsect2 id="gcut-data-get-object" role="macro" condition="since:1.1.1">
<title
>gcut_data_get_object()</title>
<indexterm zone="gcut-data-get-object" role="1.1.1"
><primary
>gcut_data_get_object</primary
></indexterm>
<programlisting language="C"
>#define             gcut_data_get_object(data, field_name)</programlisting>
<para
><parameter
>field_name</parameter
>フィールドの値を<link linkend="GObject"
><type
>GObject</type
></link
>として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-object.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.1"
>1.1.1</link
></para
></refsect2>
<refsect2 id="gcut-data-get-boolean" role="macro" condition="since:1.1.3">
<title
>gcut_data_get_boolean()</title>
<indexterm zone="gcut-data-get-boolean" role="1.1.3"
><primary
>gcut_data_get_boolean</primary
></indexterm>
<programlisting language="C"
>#define             gcut_data_get_boolean(data, field_name)</programlisting>
<para
><parameter
>field_name</parameter
>の値を真偽値として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-boolean.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.3"
>1.1.3</link
></para
></refsect2>
<refsect2 id="gcut-data-get-double" role="macro" condition="since:1.1.3">
<title
>gcut_data_get_double()</title>
<indexterm zone="gcut-data-get-double" role="1.1.3"
><primary
>gcut_data_get_double</primary
></indexterm>
<programlisting language="C"
>#define             gcut_data_get_double(data, field_name)</programlisting>
<para
><parameter
>field_name</parameter
>の値を倍精度浮動小数点数として取得します。</para>
<refsect3 id="gcut-data-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
>data</para
></entry>
<entry role="parameter_description"
><para
><link linkend="gcut-add-datum"
><function
>gcut_add_datum()</function
></link
>で追加したデータ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>フィールド名。</para
></entry>
<entry role="parameter_description"
><para
>フィールド名。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-data-get-double.returns" role="returns">
<title
>Returns</title>
<para
><parameter
>field_name</parameter
>に対応するフィールドの値。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.3"
>1.1.3</link
></para
></refsect2>

</refsect1>

</refentry>
