<?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-Test-Utilities-with-GLib-support">
<refmeta>
<refentrytitle role="top_of_page" id="cutter-Test-Utilities-with-GLib-support.top_of_page"
>Test Utilities with GLib support</refentrytitle>
<manvolnum
>3</manvolnum>
<refmiscinfo
>Cutterライブラリ</refmiscinfo>
</refmeta>
<refnamediv>
<refname
>Test Utilities with GLib support</refname>
<refpurpose
>テストをもっと簡単に書くためのGLibサポート付きユーティリティ。</refpurpose>
</refnamediv>

<refsect1 id="cutter-Test-Utilities-with-GLib-support.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="GObject"
><returnvalue
>GObject</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-object"
>gcut_take_object</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GError"
><returnvalue
>GError</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-error"
>gcut_take_error</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-list"
>gcut_take_list</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-hash-table"
>gcut_take_hash_table</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-take-string"
>gcut_take_string</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-take-new-string"
>gcut_take_new_string</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-take-bytes"
>gcut_take_bytes</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-list-new"
>gcut_list_new</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-list-int-new"
>gcut_list_int_new</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-list-uint-new"
>gcut_list_uint_new</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-list-string-new"
>gcut_list_string_new</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-list-string-new-array"
>gcut_list_string_new_array</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-new-list-int"
>gcut_take_new_list_int</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-new-list-uint"
>gcut_take_new_list_uint</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-new-list-string"
>gcut_take_new_list_string</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-take-new-list-string-backward-compatibility"
>gcut_take_new_list_string_backward_compatibility</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-new-list-string-array"
>gcut_take_new_list_string_array</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-take-new-list-object"
>gcut_take_new_list_object</link
><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="gcut-list-string-free"
>gcut_list_string_free</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="gcut-list-object-free"
>gcut_list_object_free</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-hash-table-string-string-new"
>gcut_hash_table_string_string_new</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-hash-table-string-string-new-va-list"
>gcut_hash_table_string_string_new_va_list</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-take-new-hash-table-string-string"
>gcut_take_new_hash_table_string_string</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="define_keyword"
>#define</entry
><entry role="function_name"
><link linkend="gcut-get-fixture-data"
>gcut_get_fixture_data</link
><phrase role="c_punctuation"
>()</phrase
></entry
></row>

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


<refsect1 id="cutter-Test-Utilities-with-GLib-support.description" role="desc">
<title role="desc.title"
>説明</title>
<para
>テストを書くためには、テスト環境を前処理・後処理するコードや、検証する結果を準備するコードなどたくさんのコードを書く必要があります。Cutterはもっと簡単にテストを書くためにユーティリティを提供します。</para>
<para
>このユーティリティはGLibと一緒に使います。</para>

</refsect1>
<refsect1 id="cutter-Test-Utilities-with-GLib-support.functions_details" role="details">
<title role="details.title"
>Functions</title>
<refsect2 id="gcut-take-object" role="function" condition="since:1.0.3">
<title
>gcut_take_object&#160;()</title>
<indexterm zone="gcut-take-object" role="1.0.3"
><primary
>gcut_take_object</primary
></indexterm>
<programlisting language="C"
><link linkend="GObject"
><returnvalue
>GObject</returnvalue
></link
>&#160;*
gcut_take_object (<parameter
><link linkend="GObject"
><type
>GObject</type
></link
> *object</parameter
>);</programlisting>
<para
><parameter
>object</parameter
>の所有権をCutterに渡し、<parameter
>object</parameter
>を返します。</para>
<refsect3 id="gcut-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
>object</para
></entry>
<entry role="parameter_description"
><para
>Cutterに所有権を渡す<link linkend="GObject"
><type
>GObject</type
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-object.returns" role="returns">
<title
>Returns</title>
<para
>Cutterが所有権をもつ<parameter
>object</parameter
>。<link linkend="g-object-unref"
><function
>g_object_unref()</function
></link
>しないでください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.3"
>1.0.3</link
></para
></refsect2>
<refsect2 id="gcut-take-error" role="function" condition="since:1.0.3">
<title
>gcut_take_error&#160;()</title>
<indexterm zone="gcut-take-error" role="1.0.3"
><primary
>gcut_take_error</primary
></indexterm>
<programlisting language="C"
><link linkend="GError"
><returnvalue
>GError</returnvalue
></link
>&#160;*
gcut_take_error (<parameter
><link linkend="GError"
><type
>GError</type
></link
> *error</parameter
>);</programlisting>
<para
>Cutterに<parameter
>error</parameter
>の所有権を渡し、<parameter
>error</parameter
>それ自身を返します。</para>
<refsect3 id="gcut-take-error.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
>error</para
></entry>
<entry role="parameter_description"
><para
>Cutterに所有権を渡す<link linkend="GError"
><type
>GError</type
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-error.returns" role="returns">
<title
>Returns</title>
<para
>Cutterが所有権をもつ<link linkend="GError"
><type
>GError</type
></link
>。<link linkend="g-error-free"
><function
>g_error_free()</function
></link
>しないでください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.3"
>1.0.3</link
></para
></refsect2>
<refsect2 id="gcut-take-list" role="function" condition="since:1.0.3">
<title
>gcut_take_list&#160;()</title>
<indexterm zone="gcut-take-list" role="1.0.3"
><primary
>gcut_take_list</primary
></indexterm>
<programlisting language="C"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_take_list (<parameter
>const <link linkend="GList"
><type
>GList</type
></link
> *list</parameter
>,
                <parameter
><link linkend="CutDestroyFunction"
><type
>CutDestroyFunction</type
></link
> destroy_function</parameter
>);</programlisting>
<para
><parameter
>list</parameter
>の所有権をCutterに渡し、<parameter
>list</parameter
>それ自身を返します。</para>
<refsect3 id="gcut-take-list.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
>list</para
></entry>
<entry role="parameter_description"
><para
>Cutterに所有権を渡す<link linkend="GList"
><type
>GList</type
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>destroy_function</para
></entry>
<entry role="parameter_description"
><para
><parameter
>list</parameter
>の各要素を破棄する関数、または<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-list.returns" role="returns">
<title
>Returns</title>
<para
>Cutterが所有権を持つ<link linkend="GList"
><type
>GList</type
></link
>。<link linkend="g-list-free"
><function
>g_list_free()</function
></link
>しないでください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.3"
>1.0.3</link
></para
></refsect2>
<refsect2 id="gcut-take-hash-table" role="function" condition="since:1.0.4">
<title
>gcut_take_hash_table&#160;()</title>
<indexterm zone="gcut-take-hash-table" role="1.0.4"
><primary
>gcut_take_hash_table</primary
></indexterm>
<programlisting language="C"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;*
gcut_take_hash_table (<parameter
><link linkend="GHashTable"
><type
>GHashTable</type
></link
> *hash_table</parameter
>);</programlisting>
<para
><parameter
>hash_table</parameter
>の所有権をCutterに渡し、<parameter
>hash_table</parameter
>それ自身を返します。</para>
<refsect3 id="gcut-take-hash-table.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
>hash_table</para
></entry>
<entry role="parameter_description"
><para
>Cutterに所有権を渡す<link linkend="GHashTable"
><type
>GHashTable</type
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-hash-table.returns" role="returns">
<title
>Returns</title>
<para
>Cutterが所有権をもつ<link linkend="GHashTable"
><type
>GHashTable</type
></link
>。<link linkend="g-hash-table-unref"
><function
>g_hash_table_unref()</function
></link
>しないでください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.4"
>1.0.4</link
></para
></refsect2>
<refsect2 id="gcut-take-string" role="macro" condition="since:1.1.6">
<title
>gcut_take_string()</title>
<indexterm zone="gcut-take-string" role="1.1.6"
><primary
>gcut_take_string</primary
></indexterm>
<programlisting language="C"
>#define             gcut_take_string(string)</programlisting>
<para
><parameter
>string</parameter
>の所有権をCutterに渡し、<parameter
>string</parameter
>それ自身を返します。</para>
<refsect3 id="gcut-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
>文字列。</para
></entry>
<entry role="parameter_description"
><para
>Cutterに所有権を渡す<link linkend="GString"
><type
>GString</type
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-string.returns" role="returns">
<title
>Returns</title>
<para
>Cutterが所有権を持つ<link linkend="GString"
><type
>GString</type
></link
>。<link linkend="g-string-free"
><function
>g_string_free()</function
></link
>しないでください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.6"
>1.1.6</link
></para
></refsect2>
<refsect2 id="gcut-take-new-string" role="macro" condition="since:1.1.6">
<title
>gcut_take_new_string()</title>
<indexterm zone="gcut-take-new-string" role="1.1.6"
><primary
>gcut_take_new_string</primary
></indexterm>
<programlisting language="C"
>#define             gcut_take_new_string(string)</programlisting>
<para
>渡された文字列から<link linkend="GString"
><type
>GString</type
></link
>を作成します。</para>
<refsect3 id="gcut-take-new-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
>文字列。</para
></entry>
<entry role="parameter_description"
><para
>文字列。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>も可。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-new-string.returns" role="returns">
<title
>Returns</title>
<para
>Cutterが所有権を持つ<link linkend="GString"
><type
>GString</type
></link
>。<link linkend="g-string-free"
><function
>g_string_free()</function
></link
>しないでください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.6"
>1.1.6</link
></para
></refsect2>
<refsect2 id="gcut-take-bytes" role="macro" condition="since:1.2.8">
<title
>gcut_take_bytes()</title>
<indexterm zone="gcut-take-bytes" role="1.2.8"
><primary
>gcut_take_bytes</primary
></indexterm>
<programlisting language="C"
>#define             gcut_take_bytes(bytes)</programlisting>
<para
>Passes ownership of <parameter
>bytes</parameter
> to Cutter and returns <parameter
>bytes</parameter
> itself.</para>
<refsect3 id="gcut-take-bytes.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
>bytes</para
></entry>
<entry role="parameter_description"
><para
>the <link linkend="GBytes"
><type
>GBytes</type
></link
> to be owned by Cutter.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-bytes.returns" role="returns">
<title
>Returns</title>
<para
>a <link linkend="GBytes"
><type
>GBytes</type
></link
> owned by Cutter. Don't <link linkend="g-bytes-unref"
><function
>g_bytes_unref()</function
></link
> it.</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.2.8"
>1.2.8</link
></para
></refsect2>
<refsect2 id="gcut-list-new" role="function" condition="since:1.1.1">
<title
>gcut_list_new&#160;()</title>
<indexterm zone="gcut-list-new" role="1.1.1"
><primary
>gcut_list_new</primary
></indexterm>
<programlisting language="C"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_list_new (<parameter
>const <link linkend="gpointer"
><type
>gpointer</type
></link
> element</parameter
>,
               <parameter
>...</parameter
>);</programlisting>
<para
>渡された要素を含むリストを作ります。</para>
<para
>例:</para>
<informalexample
><programlisting role="example"
><![CDATA[
GCutEgg *echo_egg, *cat_egg;

echo_egg = gcut_egg_new("echo", "Hello", NULL);
cat_egg = gcut_egg_new("cat", "/etc/hosts", NULL);
egg_list = gcut_list_new(echo_egg, cat_egg, NULL);
]]></programlisting
></informalexample>
<para
></para>
<refsect3 id="gcut-list-new.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
>element</para
></entry>
<entry role="parameter_description"
><para
>最初の<link linkend="gpointer"
><type
>gpointer</type
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>...</para
></entry>
<entry role="parameter_description"
><para
>パスの残りの要素。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-list-new.returns" role="returns">
<title
>Returns</title>
<para
>新しく割り当てられた<link linkend="GList"
><type
>GList</type
></link
>。渡された要素を持ちます。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.1"
>1.1.1</link
></para
></refsect2>
<refsect2 id="gcut-list-int-new" role="function" condition="since:1.1.5">
<title
>gcut_list_int_new&#160;()</title>
<indexterm zone="gcut-list-int-new" role="1.1.5"
><primary
>gcut_list_int_new</primary
></indexterm>
<programlisting language="C"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_list_int_new (<parameter
><link linkend="guint"
><type
>guint</type
></link
> n</parameter
>,
                   <parameter
><link linkend="gint"
><type
>gint</type
></link
> value</parameter
>,
                   <parameter
>...</parameter
>);</programlisting>
<para
>渡された整数からリストを作ります。</para>
<para
>例:</para>
<informalexample
><programlisting role="example"
><![CDATA[
gcut_list_int_new(3, -10, 1, 29); -> (-10, 1, 29)
]]></programlisting
></informalexample>
<para
></para>
<refsect3 id="gcut-list-int-new.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
>n</para
></entry>
<entry role="parameter_description"
><para
>整数の数。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>value</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>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-list-int-new.returns" role="returns">
<title
>Returns</title>
<para
>渡された整数を含む<link linkend="GList"
><type
>GList</type
></link
>。<link linkend="g-list-free"
><function
>g_list_free()</function
></link
>で開放すること。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-list-uint-new" role="function" condition="since:1.1.5">
<title
>gcut_list_uint_new&#160;()</title>
<indexterm zone="gcut-list-uint-new" role="1.1.5"
><primary
>gcut_list_uint_new</primary
></indexterm>
<programlisting language="C"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_list_uint_new (<parameter
><link linkend="guint"
><type
>guint</type
></link
> n</parameter
>,
                    <parameter
><link linkend="guint"
><type
>guint</type
></link
> value</parameter
>,
                    <parameter
>...</parameter
>);</programlisting>
<para
>渡された符号無し整数からリストを作ります。</para>
<para
>例:</para>
<informalexample
><programlisting role="example"
><![CDATA[
gcut_list_uint_new(3, 0, 1, 2); -> (0, 1, 2)
]]></programlisting
></informalexample>
<para
></para>
<refsect3 id="gcut-list-uint-new.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
>n</para
></entry>
<entry role="parameter_description"
><para
>符号無し符号整数の数。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>value</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>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-list-uint-new.returns" role="returns">
<title
>Returns</title>
<para
>渡された符号無し整数を含む<link linkend="GList"
><type
>GList</type
></link
>。<link linkend="g-list-free"
><function
>g_list_free()</function
></link
>で開放すること。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-list-string-new" role="function" condition="since:1.0.3">
<title
>gcut_list_string_new&#160;()</title>
<indexterm zone="gcut-list-string-new" role="1.0.3"
><primary
>gcut_list_string_new</primary
></indexterm>
<programlisting language="C"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_list_string_new (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *value</parameter
>,
                      <parameter
>...</parameter
>);</programlisting>
<para
>渡された文字列からリストを作ります。</para>
<refsect3 id="gcut-list-string-new.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
>最初の文字列。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>...</para
></entry>
<entry role="parameter_description"
><para
>リストの残りの文字列。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-list-string-new.returns" role="returns">
<title
>Returns</title>
<para
>渡された文字列を含む<link linkend="GList"
><type
>GList</type
></link
>。<link linkend="gcut-list-string-free"
><function
>gcut_list_string_free()</function
></link
>で開放すること。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.3"
>1.0.3</link
></para
></refsect2>
<refsect2 id="gcut-list-string-new-array" role="function" condition="since:1.0.6">
<title
>gcut_list_string_new_array&#160;()</title>
<indexterm zone="gcut-list-string-new-array" role="1.0.6"
><primary
>gcut_list_string_new_array</primary
></indexterm>
<programlisting language="C"
><link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_list_string_new_array (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> **strings</parameter
>);</programlisting>
<para
>渡された文字列配列からリストを作ります。</para>
<refsect3 id="gcut-list-string-new-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
>文字列。</para
></entry>
<entry role="parameter_description"
><para
>文字列の配列。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-list-string-new-array.returns" role="returns">
<title
>Returns</title>
<para
>渡された文字列配列と同じ内容の<link linkend="GList"
><type
>GList</type
></link
>。<link linkend="gcut-list-string-free"
><function
>gcut_list_string_free()</function
></link
>で開放すること。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-take-new-list-int" role="function" condition="since:1.1.5">
<title
>gcut_take_new_list_int&#160;()</title>
<indexterm zone="gcut-take-new-list-int" role="1.1.5"
><primary
>gcut_take_new_list_int</primary
></indexterm>
<programlisting language="C"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_take_new_list_int (<parameter
><link linkend="guint"
><type
>guint</type
></link
> n</parameter
>,
                        <parameter
><link linkend="gint"
><type
>gint</type
></link
> value</parameter
>,
                        <parameter
>...</parameter
>);</programlisting>
<para
>渡された整数からリストを作ります。作られたリストはCutterが所有権を持ちます。</para>
<para
>例:</para>
<informalexample
><programlisting role="example"
><![CDATA[
gcut_take_new_list_int(3, -10, 1, 29); -> (-10, 1, 29)
]]></programlisting
></informalexample>
<para
></para>
<refsect3 id="gcut-take-new-list-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
>n</para
></entry>
<entry role="parameter_description"
><para
>整数の数。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>value</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>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-new-list-int.returns" role="returns">
<title
>Returns</title>
<para
>渡された整数と同じ内容の<link linkend="GList"
><type
>GList</type
></link
>。Cutterが所有権を持ちます。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-take-new-list-uint" role="function" condition="since:1.1.5">
<title
>gcut_take_new_list_uint&#160;()</title>
<indexterm zone="gcut-take-new-list-uint" role="1.1.5"
><primary
>gcut_take_new_list_uint</primary
></indexterm>
<programlisting language="C"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_take_new_list_uint (<parameter
><link linkend="guint"
><type
>guint</type
></link
> n</parameter
>,
                         <parameter
><link linkend="guint"
><type
>guint</type
></link
> value</parameter
>,
                         <parameter
>...</parameter
>);</programlisting>
<para
>渡された符号無し整数からリストを作ります。作られたリストはCutterが所有権を持ちます。</para>
<para
>例:</para>
<informalexample
><programlisting role="example"
><![CDATA[
gcut_take_new_list_uint(3, 0, 1, 2); -> (0, 1, 2)
]]></programlisting
></informalexample>
<para
></para>
<refsect3 id="gcut-take-new-list-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
>n</para
></entry>
<entry role="parameter_description"
><para
>符号無し符号整数の数。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>value</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>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-new-list-uint.returns" role="returns">
<title
>Returns</title>
<para
>渡された符号無し整数と同じ内容の<link linkend="GList"
><type
>GList</type
></link
>。Cutterが所有権を持ちます。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-take-new-list-string" role="function" condition="since:1.0.5">
<title
>gcut_take_new_list_string&#160;()</title>
<indexterm zone="gcut-take-new-list-string" role="1.0.5"
><primary
>gcut_take_new_list_string</primary
></indexterm>
<programlisting language="C"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_take_new_list_string (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *value</parameter
>,
                           <parameter
>...</parameter
>);</programlisting>
<para
>渡された文字列からリストを作ります。作られたリストはCutterが所有権を持ちます。</para>
<refsect3 id="gcut-take-new-list-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
>最初の文字列。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>...</para
></entry>
<entry role="parameter_description"
><para
>リストの残りの文字列。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-new-list-string.returns" role="returns">
<title
>Returns</title>
<para
>渡された文字列と同じ内容の<link linkend="GList"
><type
>GList</type
></link
>。Cutterが所有権を持ちます。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.5"
>1.0.5</link
></para
></refsect2>
<refsect2 id="gcut-take-new-list-string-backward-compatibility" role="macro" condition="deprecated:">
<title
>gcut_take_new_list_string_backward_compatibility()</title>
<indexterm zone="gcut-take-new-list-string-backward-compatibility" role="deprecated"
><primary
>gcut_take_new_list_string_backward_compatibility</primary
></indexterm>
<programlisting language="C"
>#define             gcut_take_new_list_string_backward_compatibility(value, ...)</programlisting>
<warning
><para
><literal
>gcut_take_new_list_string_backward_compatibility</literal
>は非推奨です。新しいコードでは使わないでください。</para
></warning>
</refsect2>
<refsect2 id="gcut-take-new-list-string-array" role="function" condition="since:1.0.6">
<title
>gcut_take_new_list_string_array&#160;()</title>
<indexterm zone="gcut-take-new-list-string-array" role="1.0.6"
><primary
>gcut_take_new_list_string_array</primary
></indexterm>
<programlisting language="C"
>const <link linkend="GList"
><returnvalue
>GList</returnvalue
></link
>&#160;*
gcut_take_new_list_string_array (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> **strings</parameter
>);</programlisting>
<para
>渡された文字列の配列からリストを作ります。Cutterが所有権を持ちます。</para>
<refsect3 id="gcut-take-new-list-string-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
>文字列。</para
></entry>
<entry role="parameter_description"
><para
>文字列の配列。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-new-list-string-array.returns" role="returns">
<title
>Returns</title>
<para
>渡された文字列の配列と同じ内容の<link linkend="GList"
><type
>GList</type
></link
>。Cutterが所有。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.6"
>1.0.6</link
></para
></refsect2>
<refsect2 id="gcut-take-new-list-object" role="macro" condition="since:1.1.1">
<title
>gcut_take_new_list_object()</title>
<indexterm zone="gcut-take-new-list-object" role="1.1.1"
><primary
>gcut_take_new_list_object</primary
></indexterm>
<programlisting language="C"
>#define             gcut_take_new_list_object(object, ...)</programlisting>
<para
>渡されたオブジェクトからリストを作ります。作られたリストはCutterが所有権を持ちます。</para>
<refsect3 id="gcut-take-new-list-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
>object</para
></entry>
<entry role="parameter_description"
><para
>最初の<link linkend="GObject"
><type
>GObject</type
></link
>。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>...</para
></entry>
<entry role="parameter_description"
><para
>リストの残りのオブジェクト。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-new-list-object.returns" role="returns">
<title
>Returns</title>
<para
>新しく割り当てられた<link linkend="GList"
><type
>GList</type
></link
>。リストには渡されたオブジェクトが含まれます。Cutterが所有権を持ちます。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.1"
>1.1.1</link
></para
></refsect2>
<refsect2 id="gcut-list-string-free" role="function" condition="since:1.0.3">
<title
>gcut_list_string_free&#160;()</title>
<indexterm zone="gcut-list-string-free" role="1.0.3"
><primary
>gcut_list_string_free</primary
></indexterm>
<programlisting language="C"
>詳細を示す<link linkend="gint"
><type
>gint</type
></link
>の<link linkend="GList"
><type
>GList</type
></link
>。</programlisting>
<para
><parameter
>list</parameter
>と<parameter
>list</parameter
>内にある文字列を開放します。</para>
<refsect3 id="gcut-list-string-free.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
>list</para
></entry>
<entry role="parameter_description"
><para
>開放する文字列のリスト。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.3"
>1.0.3</link
></para
></refsect2>
<refsect2 id="gcut-list-object-free" role="function" condition="since:1.1.1">
<title
>gcut_list_object_free&#160;()</title>
<indexterm zone="gcut-list-object-free" role="1.1.1"
><primary
>gcut_list_object_free</primary
></indexterm>
<programlisting language="C"
>詳細を示す<link linkend="gint"
><type
>gint</type
></link
>の<link linkend="GList"
><type
>GList</type
></link
>。</programlisting>
<para
><parameter
>list</parameter
>と中のオブジェクトを破棄します。<parameter
>list</parameter
>に<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>が含まれていても大丈夫です。</para>
<refsect3 id="gcut-list-object-free.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
>list</para
></entry>
<entry role="parameter_description"
><para
>リファレンスを減らしたい<link linkend="GObject"
><type
>GObject</type
></link
>を含んだリスト。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.1"
>1.1.1</link
></para
></refsect2>
<refsect2 id="gcut-hash-table-string-string-new" role="function" condition="since:1.0.4">
<title
>gcut_hash_table_string_string_new&#160;()</title>
<indexterm zone="gcut-hash-table-string-string-new" role="1.0.4"
><primary
>gcut_hash_table_string_string_new</primary
></indexterm>
<programlisting language="C"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;*
gcut_hash_table_string_string_new (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *key</parameter
>,
                                   <parameter
>...</parameter
>);</programlisting>
<para
>引数で指定されたキーと値のペアから、文字列のキーと値を持つハッシュテーブルを作成します。</para>
<refsect3 id="gcut-hash-table-string-string-new.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
>key</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
>残りの引数の<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端のリスト。まず、最初のキーの文字列値を指定します。続いて、任意の数だけキー・値のペアを指定します。最後に<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>を指定しなければいけません。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-hash-table-string-string-new.returns" role="returns">
<title
>Returns</title>
<para
>渡されたキー・値を持つ<link linkend="GHashTable"
><type
>GHashTable</type
></link
>。<link linkend="g-hash-table-unref"
><function
>g_hash_table_unref()</function
></link
>で開放してください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.4"
>1.0.4</link
></para
></refsect2>
<refsect2 id="gcut-hash-table-string-string-new-va-list" role="function" condition="since:1.0.5">
<title
>gcut_hash_table_string_string_new_va_list&#160;()</title>
<indexterm zone="gcut-hash-table-string-string-new-va-list" role="1.0.5"
><primary
>gcut_hash_table_string_string_new_va_list</primary
></indexterm>
<programlisting language="C"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;*
gcut_hash_table_string_string_new_va_list
                               (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *key</parameter
>,
                                <parameter
><link linkend="va-list"
><type
>va_list</type
></link
> args</parameter
>);</programlisting>
<para
>引数で指定されたキーと値のペアから、文字列のキーと値を持つハッシュテーブルを作成します。</para>
<refsect3 id="gcut-hash-table-string-string-new-va-list.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
>key</para
></entry>
<entry role="parameter_description"
><para
>最初のキー文字列。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>args</para
></entry>
<entry role="parameter_description"
><para
>残りの引数の<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端のリスト。まず、最初のキーの文字列値を指定します。続いて、任意の数だけキー・値のペアを指定します。最後に<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>を指定しなければいけません。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-hash-table-string-string-new-va-list.returns" role="returns">
<title
>Returns</title>
<para
>渡されたキー・値を持つ<link linkend="GHashTable"
><type
>GHashTable</type
></link
>。<link linkend="g-hash-table-unref"
><function
>g_hash_table_unref()</function
></link
>で開放してください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.5"
>1.0.5</link
></para
></refsect2>
<refsect2 id="gcut-take-new-hash-table-string-string" role="function" condition="since:1.0.5">
<title
>gcut_take_new_hash_table_string_string&#160;()</title>
<indexterm zone="gcut-take-new-hash-table-string-string" role="1.0.5"
><primary
>gcut_take_new_hash_table_string_string</primary
></indexterm>
<programlisting language="C"
><link linkend="GHashTable"
><returnvalue
>GHashTable</returnvalue
></link
>&#160;*
gcut_take_new_hash_table_string_string
                               (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *key</parameter
>,
                                <parameter
>...</parameter
>);</programlisting>
<para
>渡されたキー・値のペアから文字列のキー・値を持つハッシュテーブルを作成します。作成されたハッシュテーブルはCutterが所有権を持つので、<link linkend="g-hash-table-unref"
><function
>g_hash_table_unref()</function
></link
>を呼ばないでください。</para>
<refsect3 id="gcut-take-new-hash-table-string-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
>key</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
>残りの引数の<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端のリスト。まず、最初のキーの文字列値を指定します。続いて、任意の数だけキー・値のペアを指定します。最後に<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>を指定しなければいけません。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-take-new-hash-table-string-string.returns" role="returns">
<title
>Returns</title>
<para
>渡されたキー・値を持つ<link linkend="GHashTable"
><type
>GHashTable</type
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.0.5"
>1.0.5</link
></para
></refsect2>
<refsect2 id="gcut-get-fixture-data" role="macro" condition="since:1.1.6">
<title
>gcut_get_fixture_data()</title>
<indexterm zone="gcut-get-fixture-data" role="1.1.6"
><primary
>gcut_get_fixture_data</primary
></indexterm>
<programlisting language="C"
>#define             gcut_get_fixture_data(...)</programlisting>
<para
><parameter
>path</parameter
>/..."にあるフィクスチャデータを読み込み、<link linkend="GString"
><type
>GString</type
></link
>として返します。GStringはCutterが所持します。<link linkend="cut-build-fixture-data-path"
><function
>cut_build_fixture_data_path()</function
></link
>の説明にはフィクスチャデータのパスがどのように決定されるかが書かれています。</para>
<refsect3 id="gcut-get-fixture-data.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
>パス。</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
>パスの残りの要素。<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端が必須です。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-get-fixture-data.returns" role="returns">
<title
>Returns</title>
<para
>フィクスチャデータの内容が入った<link linkend="GString"
><type
>GString</type
></link
>。GStringはCutterが所持します。開放しないでください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.6"
>1.1.6</link
></para
></refsect2>

</refsect1>

</refentry>
