<?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="GCutProcess">
<refmeta>
<refentrytitle role="top_of_page" id="GCutProcess.top_of_page"
>External command</refentrytitle>
<manvolnum
>3</manvolnum>
<refmiscinfo
>Cutterライブラリ</refmiscinfo>
</refmeta>
<refnamediv>
<refname
>External command</refname>
<refpurpose
>外部コマンドを使うための便利API</refpurpose>
</refnamediv>

<refsect1 id="GCutProcess.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="GQuark"
><returnvalue
>GQuark</returnvalue
></link>
</entry
><entry role="function_name"
><link linkend="gcut-process-error-quark"
>gcut_process_error_quark</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-new"
>gcut_process_new</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-new-command-line"
>gcut_process_new_command_line</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-new-va-list"
>gcut_process_new_va_list</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-new-argv"
>gcut_process_new_argv</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-new-strings"
>gcut_process_new_strings</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-new-array"
>gcut_process_new_array</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-process-set-flags"
>gcut_process_set_flags</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GSpawnFlags"
><returnvalue
>GSpawnFlags</returnvalue
></link>
</entry
><entry role="function_name"
><link linkend="gcut-process-get-flags"
>gcut_process_get_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="gcut-process-set-env"
>gcut_process_set_env</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="gcut-process-get-env"
>gcut_process_get_env</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-process-run"
>gcut_process_run</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GPid"
><returnvalue
>GPid</returnvalue
></link>
</entry
><entry role="function_name"
><link linkend="gcut-process-get-pid"
>gcut_process_get_pid</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-process-wait"
>gcut_process_wait</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-process-kill"
>gcut_process_kill</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-process-write"
>gcut_process_write</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GIOStatus"
><returnvalue
>GIOStatus</returnvalue
></link>
</entry
><entry role="function_name"
><link linkend="gcut-process-flush"
>gcut_process_flush</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GString"
><returnvalue
>GString</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-output-string"
>gcut_process_get_output_string</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GString"
><returnvalue
>GString</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-error-string"
>gcut_process_get_error_string</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GIOChannel"
><returnvalue
>GIOChannel</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-input-channel"
>gcut_process_get_input_channel</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GIOChannel"
><returnvalue
>GIOChannel</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-output-channel"
>gcut_process_get_output_channel</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GIOChannel"
><returnvalue
>GIOChannel</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-error-channel"
>gcut_process_get_error_channel</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GInputStream"
><returnvalue
>GInputStream</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-output-stream"
>gcut_process_get_output_stream</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GInputStream"
><returnvalue
>GInputStream</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-error-stream"
>gcut_process_get_error_stream</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-process-get-forced-termination-wait-time"
>gcut_process_get_forced_termination_wait_time</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-process-set-forced-termination-wait-time"
>gcut_process_set_forced_termination_wait_time</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>
<row
><entry role="function_type"
><link linkend="GCutEventLoop"
><returnvalue
>GCutEventLoop</returnvalue
></link
>&#160;* </entry
><entry role="function_name"
><link linkend="gcut-process-get-event-loop"
>gcut_process_get_event_loop</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-process-set-event-loop"
>gcut_process_set_event_loop</link
>&#160;<phrase role="c_punctuation"
>()</phrase
></entry
></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GCutProcess.properties" role="properties">
<title role="properties.title"
>プロパティ</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row
><entry role="property_type"
><link linkend="gpointer"
><type
>gpointer</type
></link
></entry
><entry role="property_name"
><link linkend="GCutProcess--command"
>command</link
></entry
><entry role="property_flags"
>Read / Write</entry
></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GCutProcess.signals" role="signal_proto">
<title role="signal_proto.title"
>シグナル</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row
><entry role="signal_type"
><link linkend="void"
><returnvalue
>void</returnvalue
></link
></entry
><entry role="signal_name"
><link linkend="GCutProcess-error"
>error</link
></entry
><entry role="signal_flags"
><link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></entry
></row>
<row
><entry role="signal_type"
><link linkend="void"
><returnvalue
>void</returnvalue
></link
></entry
><entry role="signal_name"
><link linkend="GCutProcess-error-received"
>error-received</link
></entry
><entry role="signal_flags"
><link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></entry
></row>
<row
><entry role="signal_type"
><link linkend="void"
><returnvalue
>void</returnvalue
></link
></entry
><entry role="signal_name"
><link linkend="GCutProcess-output-received"
>output-received</link
></entry
><entry role="signal_flags"
><link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></entry
></row>
<row
><entry role="signal_type"
><link linkend="void"
><returnvalue
>void</returnvalue
></link
></entry
><entry role="signal_name"
><link linkend="GCutProcess-reaped"
>reaped</link
></entry
><entry role="signal_flags"
><link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></entry
></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GCutProcess.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="GCUT-PROCESS-ERROR:CAPS"
>GCUT_PROCESS_ERROR</link
></entry
></row>
<row
><entry role="datatype_keyword"
>enum</entry
><entry role="function_name"
><link linkend="GCutProcessError"
>GCutProcessError</link
></entry
></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GCutProcess.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title"
>オブジェクト階層</title>
<screen
><link linkend="GObject"
>GObject</link>
    <phrase role="lineart"
>&#9584;&#9472;&#9472;</phrase
> GCutProcess
</screen>
</refsect1>


<refsect1 id="GCutProcess.description" role="desc">
<title role="desc.title"
>説明</title>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>は外部コマンドの実行・通信・終了をカプセル化します。<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>はエラーを<link linkend="GError"
><type
>GError</type
></link
>として報告します。エラーは<link linkend="gcut-assert-error"
><function
>gcut_assert_error()</function
></link
>を使うことにより簡単に検証できます。</para>
<para
>外部コマンドは<link linkend="gcut-process-new"
><function
>gcut_process_new()</function
></link
>、<link linkend="gcut-process-new-strings"
><function
>gcut_process_new_strings()</function
></link
>などのようなコンストラクタで指定します。この時点では外部コマンドは実行されません。<link linkend="gcut-process-hatch"
><function
>gcut_process_hatch()</function
></link
>で指定された外部コマンドが実行されます。</para>
<para
>外部コマンドの標準出力・エラー出力は<link linkend="GCutProcess-output-received"
><type
>"output-received"</type
></link
>シグナル・<link linkend="GCutProcess-error-received"
><type
>"error-received"</type
></link
>シグナル、あるいは、<link linkend="gcut-process-get-output"
><function
>gcut_process_get_output()</function
></link
>・<link linkend="gcut-process-get-error"
><function
>gcut_process_get_error()</function
></link
>が返す<link linkend="GIOChannel"
><type
>GIOChannel</type
></link
>で取得できます。<link linkend="gcut-process-write"
><function
>gcut_process_write()</function
></link
>は外部コマンドの標準入力にデータを書き込みます。</para>
<para
>外部コマンドの終了を待つためには<link linkend="gcut-process-wait"
><function
>gcut_process_wait()</function
></link
>を使うことができます。無限待ちを避けるために、タイムアウトを指定することができます。</para>
<para
>例:</para>
<informalexample
><programlisting role="example"
><![CDATA[
static GString *output_string;
static GCutProcess *process;

void
cut_setup (void)
{
    output_string = g_string_new(NULL);
    process = NULL;
}

void
cut_teardown (void)
{
    if (output_string)
        g_string_free(output_string, TRUE);
    if (process)
        g_object_unref(process);
}

static void
cb_output_received (GCutProcess *process, const gchar *chunk, gsize size,
                    gpointer user_data)
{
    g_string_append_len(output_string, chunk, size);
}

void
test_echo (void)
{
    GError *error = NULL;

    process = gcut_process_new("echo", "XXX", NULL);
    g_signal_connect(process, "receive-output",
                     G_CALLBACK(cb_output_received), NULL);

    gcut_process_run(process, &error);
    gcut_assert_error(error);

    gcut_process_wait(process, 1000, &error);
    gcut_assert_error(error);
    cut_assert_equal_string("XXX\n", output_string->str);
}
]]></programlisting
></informalexample>
<para
></para>

</refsect1>
<refsect1 id="GCutProcess.functions_details" role="details">
<title role="details.title"
>Functions</title>
<refsect2 id="gcut-process-error-quark" role="function">
<title
>gcut_process_error_quark&#160;()</title>
<indexterm zone="gcut-process-error-quark"
><primary
>gcut_process_error_quark</primary
></indexterm>
<programlisting language="C"
><link linkend="GQuark"><returnvalue>GQuark</returnvalue></link>
gcut_process_error_quark (<parameter><type>void</type></parameter>);</programlisting>
</refsect2>
<refsect2 id="gcut-process-new" role="function" condition="since:1.1.5">
<title
>gcut_process_new&#160;()</title>
<indexterm zone="gcut-process-new" role="1.1.5"
><primary
>gcut_process_new</primary
></indexterm>
<programlisting language="C"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;*
gcut_process_new (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *command</parameter
>,
                  <parameter
>...</parameter
>);</programlisting>
<para
><parameter
>command</parameter
>を実行する新しい<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクトを生成します。</para>
<refsect3 id="gcut-process-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
>command</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
><parameter
>command</parameter
>の引数 </para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-new.returns" role="returns">
<title
>Returns</title>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクト。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-new-command-line" role="function" condition="since:1.1.5">
<title
>gcut_process_new_command_line&#160;()</title>
<indexterm zone="gcut-process-new-command-line" role="1.1.5"
><primary
>gcut_process_new_command_line</primary
></indexterm>
<programlisting language="C"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;*
gcut_process_new_command_line (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *command_line</parameter
>);</programlisting>
<para
><parameter
>command_line</parameter
>を実行する新しい<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクトを生成します。</para>
<refsect3 id="gcut-process-new-command-line.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>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-new-command-line.returns" role="returns">
<title
>Returns</title>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクト。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-new-va-list" role="function" condition="since:1.1.5">
<title
>gcut_process_new_va_list&#160;()</title>
<indexterm zone="gcut-process-new-va-list" role="1.1.5"
><primary
>gcut_process_new_va_list</primary
></indexterm>
<programlisting language="C"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;*
gcut_process_new_va_list (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> *command</parameter
>,
                          <parameter
><link linkend="va-list"
><type
>va_list</type
></link
> args</parameter
>);</programlisting>
<para
><parameter
>command</parameter
>を実行する新しい<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクトを生成します。</para>
<refsect3 id="gcut-process-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
>command</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
><parameter
>command</parameter
>の引数 </para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-new-va-list.returns" role="returns">
<title
>Returns</title>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクト。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-new-argv" role="function" condition="since:1.1.5">
<title
>gcut_process_new_argv&#160;()</title>
<indexterm zone="gcut-process-new-argv" role="1.1.5"
><primary
>gcut_process_new_argv</primary
></indexterm>
<programlisting language="C"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;*
gcut_process_new_argv (<parameter
><link linkend="gint"
><type
>gint</type
></link
> argc</parameter
>,
                       <parameter
><link linkend="gchar"
><type
>gchar</type
></link
> **argv</parameter
>);</programlisting>
<para
><parameter
>command</parameter
>を実行する新しい<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクトを生成します。</para>
<refsect3 id="gcut-process-new-argv.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
>argc</para
></entry>
<entry role="parameter_description"
><para
><parameter
>argv</parameter
>の要素数 </para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>argv</para
></entry>
<entry role="parameter_description"
><para
>実行する外部コマンド名とコマンド引数。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-new-argv.returns" role="returns">
<title
>Returns</title>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクト。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-new-strings" role="function" condition="since:1.1.5">
<title
>gcut_process_new_strings&#160;()</title>
<indexterm zone="gcut-process-new-strings" role="1.1.5"
><primary
>gcut_process_new_strings</primary
></indexterm>
<programlisting language="C"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;*
gcut_process_new_strings (<parameter
>const <link linkend="gchar"
><type
>gchar</type
></link
> **command</parameter
>);</programlisting>
<para
><parameter
>command</parameter
>を実行する新しい<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクトを生成します。</para>
<refsect3 id="gcut-process-new-strings.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
>command</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-process-new-strings.returns" role="returns">
<title
>Returns</title>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクト。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-new-array" role="function" condition="since:1.1.5">
<title
>gcut_process_new_array&#160;()</title>
<indexterm zone="gcut-process-new-array" role="1.1.5"
><primary
>gcut_process_new_array</primary
></indexterm>
<programlisting language="C"
><link linkend="GCutProcess"
><returnvalue
>GCutProcess</returnvalue
></link
>&#160;*
gcut_process_new_array (<parameter
><link linkend="GArray"
><type
>GArray</type
></link
> *command</parameter
>);</programlisting>
<para
><parameter
>command</parameter
>を実行する新しい<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクトを生成します。</para>
<refsect3 id="gcut-process-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
>command</para
></entry>
<entry role="parameter_description"
><para
>実行する外部コマンド名とコマンド引数。<link linkend="GArray"
><type
>GArray</type
></link
>は0終端にして下さい。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-new-array.returns" role="returns">
<title
>Returns</title>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクト。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-set-flags" role="function" condition="since:1.1.5">
<title
>gcut_process_set_flags&#160;()</title>
<indexterm zone="gcut-process-set-flags" role="1.1.5"
><primary
>gcut_process_set_flags</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
gcut_process_set_flags (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                        <parameter><link linkend="GSpawnFlags"><type>GSpawnFlags</type></link> flags</parameter>);</programlisting>
<para
>外部コマンドを実行するときの<parameter
>flags</parameter
>を設定します。</para>
<refsect3 id="gcut-process-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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>flags</para
></entry>
<entry role="parameter_description"
><para
><link linkend="g-spawn-async-with-pipes"
><function
>g_spawn_async_with_pipes()</function
></link
>に渡すフラグ。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-flags" role="function" condition="since:1.1.5">
<title
>gcut_process_get_flags&#160;()</title>
<indexterm zone="gcut-process-get-flags" role="1.1.5"
><primary
>gcut_process_get_flags</primary
></indexterm>
<programlisting language="C"
><link linkend="GSpawnFlags"><returnvalue>GSpawnFlags</returnvalue></link>
gcut_process_get_flags (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>);</programlisting>
<para
>外部コマンドを実行する時の<parameter
>flags</parameter
>を取得します。</para>
<refsect3 id="gcut-process-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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-flags.returns" role="returns">
<title
>Returns</title>
<para
>外部コマンドを実行するときのフラグ。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-set-env" role="function" condition="since:1.1.5">
<title
>gcut_process_set_env&#160;()</title>
<indexterm zone="gcut-process-set-env" role="1.1.5"
><primary
>gcut_process_set_env</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
gcut_process_set_env (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                      <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                      <parameter>...</parameter>);</programlisting>
<para
>外部コマンドの環境変数を設定します。</para>
<refsect3 id="gcut-process-set-env.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<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
><parameter
>name</parameter
>に対応する値。その後に、名前と値のペアを任意の数だけ指定します。最後の引数は<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.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-env" role="function" condition="since:1.1.5">
<title
>gcut_process_get_env&#160;()</title>
<indexterm zone="gcut-process-get-env" role="1.1.5"
><primary
>gcut_process_get_env</primary
></indexterm>
<programlisting language="C"
><link linkend="gchar"
><returnvalue
>gchar</returnvalue
></link
>&#160;**
gcut_process_get_env (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<para
>外部コマンドの環境変数を取得します。</para>
<refsect3 id="gcut-process-get-env.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-env.returns" role="returns">
<title
>Returns</title>
<para
>新しく割り当てられた<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>終端の環境変数のリスト（"名前1=値1", "名前2=値2", ..., <link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>）を返します。必要がなくなったら<link linkend="g-strfreev"
><function
>g_strfreev()</function
></link
>で開放してください。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-run" role="function" condition="since:1.1.5">
<title
>gcut_process_run&#160;()</title>
<indexterm zone="gcut-process-run" role="1.1.5"
><primary
>gcut_process_run</primary
></indexterm>
<programlisting language="C"
><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_process_run (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                  <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para
>新しい外部プロセスを実行します。</para>
<refsect3 id="gcut-process-run.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>error</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-process-run.returns" role="returns">
<title
>Returns</title>
<para
>成功したときは<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-process-get-pid" role="function" condition="since:1.1.5">
<title
>gcut_process_get_pid&#160;()</title>
<indexterm zone="gcut-process-get-pid" role="1.1.5"
><primary
>gcut_process_get_pid</primary
></indexterm>
<programlisting language="C"
>詳細を示す<link linkend="guint"
><type
>guint</type
></link
>の<link linkend="GList"
><type
>GList</type
></link
>です。</programlisting>
<para
>実行している外部プロセスのプロセスIDを取得します。外部コマンドが実行されていない場合は0が返ります。</para>
<refsect3 id="gcut-process-get-pid.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-pid.returns" role="returns">
<title
>Returns</title>
<para
>実行中の外部コマンドのプロセスID。実行していない場合は0。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-wait" role="function" condition="since:1.1.5">
<title
>gcut_process_wait&#160;()</title>
<indexterm zone="gcut-process-wait" role="1.1.5"
><primary
>gcut_process_wait</primary
></indexterm>
<programlisting language="C"
><link linkend="gint"><returnvalue>gint</returnvalue></link>
gcut_process_wait (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                   <parameter><link linkend="guint"><type>guint</type></link> timeout</parameter>,
                   <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para
>実行中の外部プロセスが終了することを<parameter
>timeout</parameter
>ミリ秒待ちます。外部コマンドが<parameter
>timeout</parameter
>ミリ秒以内に終了しなかった場合は、<link linkend="GCUT-PROCESS-ERROR-TIMEOUT:CAPS"
><literal
>GCUT_PROCESS_ERROR_TIMEOUT</literal
></link
>エラーが設定され、-1が返ります。外部プロセスが実行されていない場合は、<link linkend="GCUT-PROCESS-ERROR-NOT-RUNNING:CAPS"
><literal
>GCUT_PROCESS_ERROR_NOT_RUNNING</literal
></link
>エラーが設定され、-1が返ります。</para>
<refsect3 id="gcut-process-wait.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></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>
<row
><entry role="parameter_name"
><para
>error</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-process-wait.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスが終了した場合は終了ステータス。そうでない場合は-1。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-kill" role="function" condition="since:1.1.5">
<title
>gcut_process_kill&#160;()</title>
<indexterm zone="gcut-process-kill" role="1.1.5"
><primary
>gcut_process_kill</primary
></indexterm>
<programlisting language="C"
><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_process_kill (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                   <parameter><link linkend="gint"><type>gint</type></link> signal_number</parameter>,
                   <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para
>外部プロセスに<parameter
>signal_number</parameter
>シグナルを送ります。</para>
<refsect3 id="gcut-process-kill.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>signal_number</para
></entry>
<entry role="parameter_description"
><para
>外部プロセスに送るシグナル番号。</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>error</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-process-kill.returns" role="returns">
<title
>Returns</title>
<para
>成功したときは<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-process-write" role="function" condition="since:1.1.5">
<title
>gcut_process_write&#160;()</title>
<indexterm zone="gcut-process-write" role="1.1.5"
><primary
>gcut_process_write</primary
></indexterm>
<programlisting language="C"
><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gcut_process_write (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *chunk</parameter>,
                    <parameter><link linkend="gsize"><type>gsize</type></link> size</parameter>,
                    <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para
>外部プロセスの標準入力に<parameter
>chunk</parameter
>を書き込みます。</para>
<refsect3 id="gcut-process-write.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>chunk</para
></entry>
<entry role="parameter_description"
><para
>書き込むデータ</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>size</para
></entry>
<entry role="parameter_description"
><para
><parameter
>chunk</parameter
>のサイズ </para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>error</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-process-write.returns" role="returns">
<title
>Returns</title>
<para
>成功したときは<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-process-flush" role="function" condition="since:1.1.5">
<title
>gcut_process_flush&#160;()</title>
<indexterm zone="gcut-process-flush" role="1.1.5"
><primary
>gcut_process_flush</primary
></indexterm>
<programlisting language="C"
><link linkend="GIOStatus"><returnvalue>GIOStatus</returnvalue></link>
gcut_process_flush (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                    <parameter><link linkend="GError"><type>GError</type></link> **error</parameter>);</programlisting>
<para
>外部プロセスの標準出力から読み込んだデータ。</para>
<refsect3 id="gcut-process-flush.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>error</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-process-flush.returns" role="returns">
<title
>Returns</title>
<para
>the status of the operation: One of <link linkend="G-IO-STATUS-NORMAL:CAPS"
><literal
>G_IO_STATUS_NORMAL</literal
></link
>, <link linkend="G-IO-STATUS-AGAIN:CAPS"
><literal
>G_IO_STATUS_AGAIN</literal
></link
>, or <link linkend="G-IO-STATUS-ERROR:CAPS"
><literal
>G_IO_STATUS_ERROR</literal
></link
>.</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-output-string" role="function" condition="since:1.1.5">
<title
>gcut_process_get_output_string&#160;()</title>
<indexterm zone="gcut-process-get-output-string" role="1.1.5"
><primary
>gcut_process_get_output_string</primary
></indexterm>
<programlisting language="C"
><link linkend="GString"
><returnvalue
>GString</returnvalue
></link
>&#160;*
gcut_process_get_output_string (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<refsect3 id="gcut-process-get-output-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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-output-string.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスの標準出力の結果をすべて持った<link linkend="GString"
><type
>GString</type
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-error-string" role="function" condition="since:1.1.5">
<title
>gcut_process_get_error_string&#160;()</title>
<indexterm zone="gcut-process-get-error-string" role="1.1.5"
><primary
>gcut_process_get_error_string</primary
></indexterm>
<programlisting language="C"
><link linkend="GString"
><returnvalue
>GString</returnvalue
></link
>&#160;*
gcut_process_get_error_string (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<refsect3 id="gcut-process-get-error-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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-error-string.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスの標準エラー出力の結果をすべて持った<link linkend="GString"
><type
>GString</type
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-input-channel" role="function" condition="since:1.1.5">
<title
>gcut_process_get_input_channel&#160;()</title>
<indexterm zone="gcut-process-get-input-channel" role="1.1.5"
><primary
>gcut_process_get_input_channel</primary
></indexterm>
<programlisting language="C"
><link linkend="GIOChannel"
><returnvalue
>GIOChannel</returnvalue
></link
>&#160;*
gcut_process_get_input_channel (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<para
>外部プロセスの標準入力と結びついた<link linkend="GIOChannel"
><type
>GIOChannel</type
></link
>を取得します。</para>
<refsect3 id="gcut-process-get-input-channel.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-input-channel.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスが実行中の場合は<link linkend="GIOChannel"
><type
>GIOChannel</type
></link
>。そうでない場合は<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-output-channel" role="function" condition="since:1.1.5">
<title
>gcut_process_get_output_channel&#160;()</title>
<indexterm zone="gcut-process-get-output-channel" role="1.1.5"
><primary
>gcut_process_get_output_channel</primary
></indexterm>
<programlisting language="C"
><link linkend="GIOChannel"
><returnvalue
>GIOChannel</returnvalue
></link
>&#160;*
gcut_process_get_output_channel (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<para
>外部プロセスの標準出力と結びついた<link linkend="GIOChannel"
><type
>GIOChannel</type
></link
>を取得します。</para>
<refsect3 id="gcut-process-get-output-channel.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-output-channel.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスが実行中の場合は<link linkend="GIOChannel"
><type
>GIOChannel</type
></link
>。そうでない場合は<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-error-channel" role="function" condition="since:1.1.5">
<title
>gcut_process_get_error_channel&#160;()</title>
<indexterm zone="gcut-process-get-error-channel" role="1.1.5"
><primary
>gcut_process_get_error_channel</primary
></indexterm>
<programlisting language="C"
><link linkend="GIOChannel"
><returnvalue
>GIOChannel</returnvalue
></link
>&#160;*
gcut_process_get_error_channel (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<para
>外部プロセスのエラー出力に結びついた<link linkend="GIOChannel"
><type
>GIOChannel</type
></link
>を返します。</para>
<refsect3 id="gcut-process-get-error-channel.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-error-channel.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスが実行中の場合は<link linkend="GIOChannel"
><type
>GIOChannel</type
></link
>。そうでない場合は<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-output-stream" role="function" condition="since:1.1.5">
<title
>gcut_process_get_output_stream&#160;()</title>
<indexterm zone="gcut-process-get-output-stream" role="1.1.5"
><primary
>gcut_process_get_output_stream</primary
></indexterm>
<programlisting language="C"
><link linkend="GInputStream"
><returnvalue
>GInputStream</returnvalue
></link
>&#160;*
gcut_process_get_output_stream (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<para
>外部プロセスの標準出力と結びついた<link linkend="GInputStream"
><type
>GInputStream</type
></link
>を取得します。</para>
<refsect3 id="gcut-process-get-output-stream.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-output-stream.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスが実行中の場合は<link linkend="GInputStream"
><type
>GInputStream</type
></link
>。そうでない場合は<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-error-stream" role="function" condition="since:1.1.5">
<title
>gcut_process_get_error_stream&#160;()</title>
<indexterm zone="gcut-process-get-error-stream" role="1.1.5"
><primary
>gcut_process_get_error_stream</primary
></indexterm>
<programlisting language="C"
><link linkend="GInputStream"
><returnvalue
>GInputStream</returnvalue
></link
>&#160;*
gcut_process_get_error_stream (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<para
>外部プロセスの標準エラー出力に結びついた<link linkend="GInputStream"
><type
>GInputStream</type
></link
>を返します。</para>
<refsect3 id="gcut-process-get-error-stream.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-error-stream.returns" role="returns">
<title
>Returns</title>
<para
>外部プロセスが実行中の場合は<link linkend="GInputStream"
><type
>GInputStream</type
></link
>。そうでない場合は<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-forced-termination-wait-time" role="function" condition="since:1.1.5">
<title
>gcut_process_get_forced_termination_wait_time&#160;()</title>
<indexterm zone="gcut-process-get-forced-termination-wait-time" role="1.1.5"
><primary
>gcut_process_get_forced_termination_wait_time</primary
></indexterm>
<programlisting language="C"
><link linkend="guint"><returnvalue>guint</returnvalue></link>
gcut_process_get_forced_termination_wait_time
                               (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>);</programlisting>
<para
>オブジェクトが破棄されるときに行われる外部コマンド強制終了後に待つ時間（ミリ秒）を取得します。</para>
<refsect3 id="gcut-process-get-forced-termination-wait-time.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-forced-termination-wait-time.returns" role="returns">
<title
>Returns</title>
<para
>破棄時の強制終了待ちの時間。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-set-forced-termination-wait-time" role="function" condition="since:1.1.5">
<title
>gcut_process_set_forced_termination_wait_time&#160;()</title>
<indexterm zone="gcut-process-set-forced-termination-wait-time" role="1.1.5"
><primary
>gcut_process_set_forced_termination_wait_time</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
gcut_process_set_forced_termination_wait_time
                               (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                                <parameter><link linkend="guint"><type>guint</type></link> timeout</parameter>);</programlisting>
<para
>オブジェクトが破棄されるときに行われる外部コマンド強制終了時に待つ時間（ミリ秒）を設定します。<parameter
>timeout</parameter
>が0なら外部コマンドの終了を待ちません。デフォルト値は10です。</para>
<refsect3 id="gcut-process-set-forced-termination-wait-time.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></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
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
<refsect2 id="gcut-process-get-event-loop" role="function" condition="since:1.1.6">
<title
>gcut_process_get_event_loop&#160;()</title>
<indexterm zone="gcut-process-get-event-loop" role="1.1.6"
><primary
>gcut_process_get_event_loop</primary
></indexterm>
<programlisting language="C"
><link linkend="GCutEventLoop"
><returnvalue
>GCutEventLoop</returnvalue
></link
>&#160;*
gcut_process_get_event_loop (<parameter
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
> *process</parameter
>);</programlisting>
<para
><parameter
>process</parameter
>が使っているイベントループを取得します。</para>
<refsect3 id="gcut-process-get-event-loop.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><refsect3 id="gcut-process-get-event-loop.returns" role="returns">
<title
>Returns</title>
<para
><link linkend="GCutEventLoop"
><type
>GCutEventLoop</type
></link
>。</para>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.6"
>1.1.6</link
></para
></refsect2>
<refsect2 id="gcut-process-set-event-loop" role="function" condition="since:1.1.6">
<title
>gcut_process_set_event_loop&#160;()</title>
<indexterm zone="gcut-process-set-event-loop" role="1.1.6"
><primary
>gcut_process_set_event_loop</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
gcut_process_set_event_loop (<parameter><link linkend="GCutProcess"><type>GCutProcess</type></link> *process</parameter>,
                             <parameter><link linkend="GCutEventLoop"><type>GCutEventLoop</type></link> *loop</parameter>);</programlisting>
<para
><parameter
>process</parameter
>のイベントループを設定します。<parameter
>loop</parameter
>が<link linkend="NULL:CAPS"
><literal
>NULL</literal
></link
>なら、デフォルトのGLibイベントループが使われます。</para>
<refsect3 id="gcut-process-set-event-loop.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
></para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>loop</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
><para role="since"
>Since: <link linkend="api-index-1.1.6"
>1.1.6</link
></para
></refsect2>

</refsect1>
<refsect1 id="GCutProcess.other_details" role="details">
<title role="details.title"
>Types and Values</title>
<refsect2 id="GCUT-PROCESS-ERROR:CAPS" role="macro">
<title
>GCUT_PROCESS_ERROR</title>
<indexterm zone="GCUT-PROCESS-ERROR:CAPS"
><primary
>GCUT_PROCESS_ERROR</primary
></indexterm>
<programlisting language="C"
>#define GCUT_PROCESS_ERROR           (gcut_process_error_quark())
</programlisting>
</refsect2>
<refsect2 id="GCutProcessError" role="enum" condition="since:1.1.5">
<title
>enum GCutProcessError</title>
<indexterm zone="GCutProcessError" role="1.1.5"
><primary
>GCutProcessError</primary
></indexterm>
<para
><link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>関連の操作で返されるエラーコード。</para>
<refsect3 id="GCutProcessError.members" role="enum_members">
<title
>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-COMMAND-LINE:CAPS"
>GCUT_PROCESS_ERROR_COMMAND_LINE</para
></entry>
<entry role="enum_member_description"
><para
>コマンドライン関連のエラー。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-IO-ERROR:CAPS"
>GCUT_PROCESS_ERROR_IO_ERROR</para
></entry>
<entry role="enum_member_description"
><para
>入出力エラー。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-ALREADY-RUNNING:CAPS"
>GCUT_PROCESS_ERROR_ALREADY_RUNNING</para
></entry>
<entry role="enum_member_description"
><para
>外部コマンドはすでに実行されています。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-NOT-RUNNING:CAPS"
>GCUT_PROCESS_ERROR_NOT_RUNNING</para
></entry>
<entry role="enum_member_description"
><para
>外部こもアンドが実行されていません。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-INVALID-OBJECT:CAPS"
>GCUT_PROCESS_ERROR_INVALID_OBJECT</para
></entry>
<entry role="enum_member_description"
><para
>不正な<link linkend="GCutProcess"
><type
>GCutProcess</type
></link
>オブジェクトが渡されました。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-INVALID-SIGNAL:CAPS"
>GCUT_PROCESS_ERROR_INVALID_SIGNAL</para
></entry>
<entry role="enum_member_description"
><para
>不正なシグナルが渡されました。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-PERMISSION-DENIED:CAPS"
>GCUT_PROCESS_ERROR_PERMISSION_DENIED</para
></entry>
<entry role="enum_member_description"
><para
>許可がありません。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
<row role="constant"
><entry role="enum_member_name"
><para id="GCUT-PROCESS-ERROR-TIMEOUT:CAPS"
>GCUT_PROCESS_ERROR_TIMEOUT</para
></entry>
<entry role="enum_member_description"
><para
>タイムアウト。</para>
</entry>
<entry role="enum_member_annotations"
></entry>
</row>
</tbody
></tgroup
></informaltable>
</refsect3
><para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>

</refsect1>
<refsect1 id="GCutProcess.property-details" role="property_details">
<title role="property_details.title"
>プロパティ詳細</title>
<refsect2 id="GCutProcess--command" role="property"
><title
><literal
>"command"</literal
>プロパティ</title>
<indexterm zone="GCutProcess--command"
><primary
>GCutProcess:command</primary
></indexterm>
<programlisting
>“command”                  <link linkend="gpointer"
><type
>gpointer</type
></link
></programlisting>
<para
>このプロセスが実行する外部コマンド。</para
><para
>Owner: GCutProcess</para>
<para
>Flags: Read / Write</para>
</refsect2>

</refsect1>
<refsect1 id="GCutProcess.signal-details" role="signals">
<title role="signals.title"
>シグナル詳細</title>
<refsect2 id="GCutProcess-error" role="signal"
><title
><literal
>"error"</literal
>シグナル</title>
<indexterm zone="GCutProcess-error" role="1.1.5"
><primary
>GCutProcess::error</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GCutProcess"><type>GCutProcess</type></link> *process,
               <link linkend="gpointer"><type>gpointer</type></link>     error,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para
>It is emitted each time an external process causes an error. (e.g. IO error)</para>
<refsect3 id="GCutProcess-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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
>the object which received the signal.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>error</para
></entry>
<entry role="parameter_description"
><para
>the error of an external process. (<link linkend="GError"
><literal
>GError</literal
></link
>)</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><simpara
>user_data</simpara
></entry>
<entry role="parameter_description"
><simpara
>user data set when the signal handler was connected.</simpara
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para
>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></para>
<para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2
><refsect2 id="GCutProcess-error-received" role="signal"
><title
><literal
>"error-received"</literal
>シグナル</title>
<indexterm zone="GCutProcess-error-received" role="1.1.5"
><primary
>GCutProcess::error-received</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GCutProcess"><type>GCutProcess</type></link> *process,
               <link linkend="gchar"><type>gchar</type></link>       *chunk,
               <link linkend="guint64"><type>guint64</type></link>      size,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para
>It is emitted each time an external process outputs something to its standard error output and it is read.</para>
<para
>Note that you need to run <link linkend="GCutEventLoop"
><literal
>GCutEventLoop</literal
></link
> by <link linkend="gcut-event-loop-run"
><function
>gcut_event_loop_run()</function
></link
> or <link linkend="gcut-event-loop-iterate"
><function
>gcut_event_loop_iterate()</function
></link
> for detecting an external process's output is readable.</para>
<refsect3 id="GCutProcess-error-received.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
>the object which received the signal.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>chunk</para
></entry>
<entry role="parameter_description"
><para
>the chunk read from an external process's standard error output.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>size</para
></entry>
<entry role="parameter_description"
><para
>the size of <parameter
>chunk</parameter
> . (<link linkend="gsize"
><literal
>gsize</literal
></link
>)</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><simpara
>user_data</simpara
></entry>
<entry role="parameter_description"
><simpara
>user data set when the signal handler was connected.</simpara
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para
>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></para>
<para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2
><refsect2 id="GCutProcess-output-received" role="signal"
><title
><literal
>"output-received"</literal
>シグナル</title>
<indexterm zone="GCutProcess-output-received" role="1.1.5"
><primary
>GCutProcess::output-received</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GCutProcess"><type>GCutProcess</type></link> *process,
               <link linkend="gchar"><type>gchar</type></link>       *chunk,
               <link linkend="guint64"><type>guint64</type></link>      size,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para
>It is emitted each time an external process outputs something to its standard output and it is read.</para>
<para
>Note that you need to run <link linkend="GCutEventLoop"
><literal
>GCutEventLoop</literal
></link
> by <link linkend="gcut-event-loop-run"
><function
>gcut_event_loop_run()</function
></link
> or <link linkend="gcut-event-loop-iterate"
><function
>gcut_event_loop_iterate()</function
></link
> for detecting an external process's output is readable.</para>
<refsect3 id="GCutProcess-output-received.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
>the object which received the signal.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>chunk</para
></entry>
<entry role="parameter_description"
><para
>the chunk read from an external process's standard output.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>size</para
></entry>
<entry role="parameter_description"
><para
>the size of <parameter
>chunk</parameter
> . (<link linkend="gsize"
><literal
>gsize</literal
></link
>)</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><simpara
>user_data</simpara
></entry>
<entry role="parameter_description"
><simpara
>user data set when the signal handler was connected.</simpara
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para
>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></para>
<para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2
><refsect2 id="GCutProcess-reaped" role="signal"
><title
><literal
>"reaped"</literal
>シグナル</title>
<indexterm zone="GCutProcess-reaped" role="1.1.5"
><primary
>GCutProcess::reaped</primary
></indexterm>
<programlisting language="C"
><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GCutProcess"><type>GCutProcess</type></link> *process,
               <link linkend="gint"><type>gint</type></link>         status,
               <link linkend="gpointer"><type>gpointer</type></link>     user_data)</programlisting>
<para
>It is emitted when an external process is exited.</para>
<para
>Note that you need to run <link linkend="GCutEventLoop"
><literal
>GCutEventLoop</literal
></link
> by <link linkend="gcut-event-loop-run"
><function
>gcut_event_loop_run()</function
></link
> or <link linkend="gcut-event-loop-iterate"
><function
>gcut_event_loop_iterate()</function
></link
> for detecting an external process is exited.</para>
<refsect3 id="GCutProcess-reaped.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
>プロセスID。</para
></entry>
<entry role="parameter_description"
><para
>the object which received the signal.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><para
>status</para
></entry>
<entry role="parameter_description"
><para
>the exit status of an external process.</para
></entry>
<entry role="parameter_annotations"
></entry
></row>
<row
><entry role="parameter_name"
><simpara
>user_data</simpara
></entry>
<entry role="parameter_description"
><simpara
>user data set when the signal handler was connected.</simpara
></entry>
<entry role="parameter_annotations"
></entry
></row>
</tbody
></tgroup
></informaltable>
</refsect3
><para
>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS"
>Run Last</link
></para>
<para role="since"
>Since: <link linkend="api-index-1.1.5"
>1.1.5</link
></para
></refsect2>
</refsect1>

</refentry>
