PHP マニュアル
前のページ |  | 次のページ

# readline_callback_handler_install

(PHP 5 >= 5.1.0RC1)

readline_callback_handler_install -- readline コールバックインターフェースと端末を初期化し、 プロンプトを表示して結果をすぐに返す

## 説明

bool readline_callback_handler_install ( string prompt, callback callback )

readline コールバックインターフェースを設定し、プロンプト `prompt` を表示して入力を受け取ります。 コールバック関数 `callback` はひとつのパラメータを とり、そこにはユーザの入力内容が格納されます。一度登録したコールバック インターフェースを削除せずもういちどこの関数をコールした場合、もとの インターフェースは自動的に上書きされます。

コールバック機能は stream_select() と組み合わせると 有用です。これは readline() とは異なり、 IO とユーザの入力を交互に取り扱います。

## パラメータ

`prompt`

  確認メッセージ。

`callback`

  `callback` 関数が受け取るパラメータはひとつで、 ユーザから返された入力です。

## 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。

## 例

例 1. Readline コールバックインターフェースの例

`<?php
function rl_callback($ret)
{
global $c, $prompting;
echo "You entered: $ret\n";
$c++;
if ($c > 10) {
$prompting = false;
readline_callback_handler_remove();
} else {
readline_callback_handler_install("[$c] Enter something: ", 'rl_callback');
}
}
$c = 1;
$prompting = true;
readline_callback_handler_install("[$c] Enter something: ", 'rl_callback');
while ($prompting) {
$n = stream_select($r = array(STDIN), $w = null, $e = null, null);
if ($n && in_array(STDIN, $r)) {
// read a character, will call the callback when a newline is entered
readline_callback_read_char();
}
}
echo "Prompting disabled. All done.\n";
?>`

## 参考

readline_callback_handler_remove()
readline_callback_read_char()
stream_select()

前のページ | ホーム | 次のページ
readline_add_history | 上に戻る | readline_callback_handler_remove