## 便利なHTTPクライアントAPI 便利なHTTPクライアントAPI — HTTPクライアントとして動作するためのAPI。 |

## Functions

SoupCutClient * | soupcut_client_new ()
void | soupcut_client_set_base ()
guint | soupcut_client_send_message ()
guint | soupcut_client_get ()
guint | soupcut_client_get_n_messages ()
SoupMessage * | soupcut_client_get_latest_message ()
GMainContext * | soupcut_client_get_async_context ()

## プロパティ

gboolean | async | Read / Write

## オブジェクト階層

        GObject
        ╰── SoupCutClient

## 説明

SoupCutClientオブジェクトはHTTPクライアントとして動作します。SoupCutClientは複数のリクエストやレスポンスを管理することができます。また、SoupCutClientに関連するアサーションのAPIも提供しています。

## Functions

### soupcut_client_new ()

    SoupCutClient *
    soupcut_client_new (void);

新たにSoupCutClientオブジェクトを生成して返します。

#### Returns

SoupCutClientオブジェクト。

Since: 1.0.8

### soupcut_client_set_base ()

    void
    soupcut_client_set_base (SoupCutClient *client,
                             const gchar *uri);

Set `uri` as a base uri of `client` .

#### Parameters

client | SoupCutClientオブジェクト。 |
uri | ベースURIの文字列。 |

Since: 1.0.8

### soupcut_client_send_message ()

    guint
    soupcut_client_send_message (SoupCutClient *client,
                                 SoupMessage *message);

Send `message` with `client` . `client` remebers all the messages it sent.

#### Parameters

client | SoupCutClientオブジェクト。 |
message | SoupMessageオブジェクト。 |

#### Returns

レスポンスのステータスコード。

Since: 1.0.8

### soupcut_client_get ()

    guint
    soupcut_client_get (SoupCutClient *client,
                        const gchar *uri,
                        const gchar *first_query_name,
                        ...);

Send a GET request to `uri` with queries. If the base URI of `client` is set by `soupcut_client_set_base()`, the destination URI is composed of the base URI and `uri` . If not, `uri` must be a fully qualified URI.

#### Parameters

client | SoupCutClientオブジェクト。 |
uri | URI文字列。 |
first_query_name | ひとつめのクエリパラメータの名前 |
... | pairs of query parameter names and values, starting with `first_query_name` , terminated by `NULL` |

#### Returns

レスポンスのステータスコード。

Since: 1.0.8

### soupcut_client_get_n_messages ()

    guint
    soupcut_client_get_n_messages (SoupCutClient *client);

`client`が送信した#SoupMessageの数。

#### Parameters

client | SoupCutClientオブジェクト。 |

#### Returns

SoupMessageの数。

Since: 1.0.8

### soupcut_client_get_latest_message ()

    SoupMessage *
    soupcut_client_get_latest_message (SoupCutClient *client);

`client`が最後に送信したSoupMessageオブジェクト。

#### Parameters

client | SoupCutClientオブジェクト。 |

#### Returns

最後に送信されたSoupMessageオブジェクト。

Since: 1.0.8

### soupcut_client_get_async_context ()

    GMainContext *
    soupcut_client_get_async_context (SoupCutClient *client);

Returns the asynch_context of `client` .

#### Parameters

client | SoupCutClientオブジェクト。 |

#### Returns

a GMainContext of `client` , which may be `NULL`.

Since: 1.0.8

## Types and Values

## プロパティ詳細

### The `“async”` property

      “async”                    gboolean

セッションが非同期の場合は真。

Flags: Read / Write

デフォルト値: FALSE

## 参考

HTTPクライアント・サーバ用の検証