Manuel PHP
PrécédentSuivant

readline_callback_handler_install

(no version information, might be only in CVS)

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

Description

bool readline_callback_handler_install ( string prompt, callback callback )

readline_callback_handler_install() définie une interface de calback pour readline, affiche le prompt et retourne immédiatement. La fonction callback prend un paramètre : l'entrée utilisateur retournée. Appeler cette fonction deux fois sans effacer au préalable l'interface de callback précédente effacera automatiquement et proprement l'ancienne interface.

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

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Exemples

Exemple 1. Exemple d'interface de callback Readline

<?php
function rl_callback($ret)
{
    global $c, $prompting;

    echo "Votre entrée : $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)) {
        // lit un caractère, appelera 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

readline_callback_handler_remove(), readline_callback_read_char() et stream_select().

PrécédentSommaireSuivant
readline_add_historyNiveau supérieurreadline_callback_handler_remove