説明

resource ircg_pconnect ( string $username [, string $server_ip [, int $server_port [, string $msg_format [, array $ctcp_messages [, array $user_settings [, bool $bailout_on_trivial]]]]]] )

ircg_pconnect() は、IRC サーバへの接続を 確立しようと試み、後で使用するための接続リソースハンドルを返します。

必須パラメータは username のみで、 ここでサーバ上の初期ニックネームを設定します。 server_ip および server_port はオプションで、デフォルトは 127.0.0.1 および 6667 です。

注意: 現時点では、パラメータ server_ip は ホスト名の解決を行わないため、数値表現の IP アドレスしか受け付けません。 DNS 検索はコストがかかる処理で、IRCG で行うべきです。

事前に ircg_register_format_messages() で作成した フォーマットメッセージセットの名前を msg_format に指定することで、IRC のメッセージやイベントの出力をカスタマイズ することが可能です。

ACTION (/me) のような CTCP メッセージを扱いたい場合は、 CTCP 型 (例: ACTION) からカスタムフォーマット文字列への マッピングを定義する必要があります。そうするには、 ctcp_messages に連想配列を渡します。 配列のキーが CTCP 型で、対応する値がフォーマットメッセージとなります。

IRC サーバに送信する "ident"、"password" および "realname" トークンを 連想配列として指定することが可能です。この連想配列を user_settings に設定します。

ircg_disconnect()、 ircg_is_conn_alive()、 ircg_register_format_messages() も参照ください。