diff --git a/language-snippets.ent b/language-snippets.ent index 05f702c2a7..9ef2a5b1ef 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,5 +1,5 @@ - + + + Cette fonction est disponible uniquement si la bibliothèque readline avec + laquelle PHP a été compilé la prend en charge. Elle est indisponible sur + Windows. + +'> + - - + GNU Readline @@ -22,7 +20,10 @@ ligne de commande. - À partir de PHP 7.1.0 cette extension est supportée sur Windows. + À partir de PHP 7.1.0 cette extension est supportée sur Windows, où elle est + compilée avec libedit. Toutes les fonctions ne sont pas présentes dans cette + compilation ; voir les prérequis. + L'extension readline n'est pas thread-safe ! Par conséquent l'usage de celle-ci diff --git a/reference/readline/functions/readline-callback-handler-install.xml b/reference/readline/functions/readline-callback-handler-install.xml index d5c16a7a93..799c2d050e 100644 --- a/reference/readline/functions/readline-callback-handler-install.xml +++ b/reference/readline/functions/readline-callback-handler-install.xml @@ -1,6 +1,5 @@ - - + readline_callback_handler_install @@ -27,6 +26,7 @@ l'interconnexion IO / entrée utilisateur, à la différence de readline. + &readline.system-callback-support; diff --git a/reference/readline/functions/readline-callback-handler-remove.xml b/reference/readline/functions/readline-callback-handler-remove.xml index c8a10ec0f6..5b16825ac7 100644 --- a/reference/readline/functions/readline-callback-handler-remove.xml +++ b/reference/readline/functions/readline-callback-handler-remove.xml @@ -1,7 +1,5 @@ - - - + readline_callback_handler_remove @@ -18,6 +16,7 @@ Efface un gestionnaire de rappel installé précédemment et restaure les paramètres du terminal. + &readline.system-callback-support; diff --git a/reference/readline/functions/readline-callback-read-char.xml b/reference/readline/functions/readline-callback-read-char.xml index 32c5a94441..2c9899321a 100644 --- a/reference/readline/functions/readline-callback-read-char.xml +++ b/reference/readline/functions/readline-callback-read-char.xml @@ -1,7 +1,5 @@ - - - + readline_callback_read_char @@ -20,6 +18,7 @@ readline_callback_handler_install qu'une ligne est prête à être entrée. + &readline.system-callback-support; diff --git a/reference/readline/functions/readline-list-history.xml b/reference/readline/functions/readline-list-history.xml index 94e5e5eb01..6d214dd546 100644 --- a/reference/readline/functions/readline-list-history.xml +++ b/reference/readline/functions/readline-list-history.xml @@ -1,7 +1,5 @@ - - - + readline_list_history @@ -17,6 +15,11 @@ Liste l'historique. + + Cette fonction est disponible uniquement si la bibliothèque readline avec + laquelle PHP a été compilé fournit le listage de l'historique. C'est toujours + le cas avec GNU Readline et sur Windows. + diff --git a/reference/readline/functions/readline-on-new-line.xml b/reference/readline/functions/readline-on-new-line.xml index 78b7962caa..5c5b42b745 100755 --- a/reference/readline/functions/readline-on-new-line.xml +++ b/reference/readline/functions/readline-on-new-line.xml @@ -1,7 +1,5 @@ - - - + readline_on_new_line @@ -17,6 +15,7 @@ Informe readline que le curseur est passé à une nouvelle ligne. + &readline.system-callback-support; @@ -31,14 +30,11 @@ - - &reftitle.notes; - - - Cette fonction n'est disponible que si elle est supportée par la - bibliothèque readline sous-jacente. Elle n'est pas supportée sur Windows. - - + + &reftitle.seealso; + + readline_callback_handler_install + - - + readline_redisplay @@ -17,6 +15,7 @@ Demande à readline de refaire l'affichage. + &readline.system-callback-support; @@ -30,6 +29,13 @@ &return.void; + + + &reftitle.seealso; + + readline_callback_handler_install + + - - + &reftitle.setup; @@ -20,6 +18,21 @@ et disponible en téléchargement sur &url.libedit;. + + Les deux bibliothèques ne fournissent pas les mêmes fonctionnalités, si bien + que certaines fonctions sont absentes de certaines compilations. Les fonctions + qui pilotent l'interface de rappel, + readline_callback_handler_install, + readline_callback_handler_remove, + readline_callback_read_char, + readline_redisplay et + readline_on_new_line, ne sont présentes que si la + bibliothèque sous-jacente les fournit, et sont absentes sur Windows. Appeler + une fonction absente lève une Error. + function_exists teste la présence d'une fonction donnée, + et la constante READLINE_LIB indique quelle bibliothèque + est utilisée. +