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() も参照ください。