array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.readline-callback-handler-install.php', 1 => 'readline_callback_handler_install', ), 'up' => array ( 0 => 'ref.readline.php', 1 => 'Funções da extensão Readline', ), 'prev' => array ( 0 => 'function.readline-add-history.php', 1 => 'readline_add_history', ), 'next' => array ( 0 => 'function.readline-callback-handler-remove.php', 1 => 'readline_callback_handler_remove', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/readline/functions/readline-callback-handler-install.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
readline_callback_handler_install — Inicializa a interface de chamada de retorno e o terminal de readline, mostra o prompt e retorna imediatamente
Configura uma interface de chamada de retorno readline, mostra o
prompt
e retorna imediatamente.
Chamar esta função duas vezes sem remover a interface de
chamada anterior irá automaticamente e convenientemente sobrescrever a
interface antiga.
O recurso de chamada de retorno é útil quando combinada com stream_select() já que permite as it allows intercalação de E/S e de entrada de usuário, diferentemente da função readline().
prompt
A mensagem do prompt.
callback
A função definida em callback
leva um parâmetro; a entrada
do usuário retornada.
Exemplo #1 Exemplo de Interface de Chamada de Retorno de Readline
<?php
function rl_callback($ret)
{
global $c, $prompting;
echo "Você digitou: $ret\n";
$c++;
if ($c > 10) {
$prompting = false;
readline_callback_handler_remove();
} else {
readline_callback_handler_install("[$c] Digite algo: ", 'rl_callback');
}
}
$c = 1;
$prompting = true;
readline_callback_handler_install("[$c] Digite algo: ", 'rl_callback');
while ($prompting) {
$w = NULL;
$e = NULL;
$n = stream_select($r = array(STDIN), $w, $e, null);
if ($n && in_array(STDIN, $r)) {
// lê um caractere, irá chamar a função de retorno quando uma nova linha for lida
readline_callback_read_char();
}
}
echo "Prompt desabilitado. Tudo pronto.\n";
?>