array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.readline-callback-handler-install.php', 1 => 'readline_callback_handler_install', 2 => 'Initialise l\'interface et le terminal de rappel de readline, affiche le prompt et retourne immédiatement', ), 'up' => array ( 0 => 'ref.readline.php', 1 => 'Fonctions 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' => 'fr', 'path' => 'reference/readline/functions/readline-callback-handler-install.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

readline_callback_handler_install

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

readline_callback_handler_install — Initialise l'interface et le terminal de rappel de readline, affiche le prompt et retourne immédiatement

Description

readline_callback_handler_install(string $prompt, callable $callback): true

Définit une interface de rappel pour readline, affiche le prompt et retourne immédiatement. Appeler cette fonction deux fois sans effacer au préalable l'interface de rappel précédente effacera automatiquement et proprement l'ancienne interface.

La fonctionnalité de rappel est très utile lorsque combinée à la fonction stream_select() permettant l'interconnexion IO / entrée utilisateur, à la différence de readline().

Liste de paramètres

prompt
Le message de prompt.
callback
La fonction callback prend un paramètre : l'entrée utilisateur retournée.

Valeurs de retour

Retourne toujours true.

Exemples

Exemple #1 Exemple d'interface de rappel de 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] Entrer quelque chose : ", 'rl_callback');
}
}

$c = 1;
$prompting = true;

readline_callback_handler_install("[$c] Entrer quelque chose : ", 'rl_callback');

while ($prompting) {
$w = NULL;
$e = NULL;
$n = stream_select($r = array(STDIN), $w, $e, null);
if ($n && in_array(STDIN, $r)) {
// lit un caractère, appellera la fonction de callback lorsqu'une nouvelle ligne est entrée
readline_callback_read_char();
}
}

echo "Le prompt est désactivé. Tout a été effectué.\n";
?>

Voir aussi