array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.readline.php', 1 => 'readline', 2 => 'Lê uma linha', ), 'up' => array ( 0 => 'ref.readline.php', 1 => 'Funções da extensão Readline', ), 'prev' => array ( 0 => 'ref.readline.php', 1 => 'Funções da extensão Readline', ), 'next' => array ( 0 => 'function.readline-add-history.php', 1 => 'readline_add_history', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/readline/functions/readline.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

readline

(PHP 4, PHP 5, PHP 7, PHP 8)

readline — Lê uma linha

Descrição

readline(?string $prompt = null): string|false

Lê uma única linha do usuário. Esta linha precisa ser adicionada manualmente ao histórico usando readline_add_history().

Parâmetros

prompt
Pode-se especificar uma string que será o prompt para o usuário.

Valor Retornado

Retorna uma string do usuário. A linha retornada tem o caractere de nova linha removido do final. Se não houver mais dados para ler, então false é retornado.

Exemplos

Exemplo #1 readline()

<?php
// Obtém três comandos do usuário
for ($i=0; $i < 3; $i++) {
$line = readline("Command: ");
readline_add_history($line);
}

// Mostra o histórico
print_r(readline_list_history());

// Mostra as variáveis
print_r(readline_info());
?>