readline_clear_history
Note: the first argument passed to the registered function is NOT the whole command line as entered by the user, but only the last part, i.e. the part after the last space.
e.g.:
<?php
function my_readline_completion_function($string, $index) {
// If the user is typing:
// mv file.txt directo[TAB]
// then:
// $string = directo
// the $index is the place of the cursor in the line:
// $index = 19;
$array = array(
'ls',
'mv',
'dar',
'exit',
'quit',
);
// Here, I decide not to return filename autocompletion for the first argument (0th argument).
if ($index) {
$ls = `ls`;
$lines = explode("\n", $ls);
foreach ($lines AS $key => $line) {
if (is_dir($line)) {
$lines[$key] .= '/';
}
$array[] = $lines[$key];
}
}
// This will return both our list of functions, and, possibly, a list of files in the current filesystem.
// php will filter itself according to what the user is typing.
return $array;
}
?>
readline_completion_function
(PHP 4, PHP 5)
readline_completion_function — Registriert eine Vervollständigungsfunktion
Beschreibung
Diese Funktion registriert eine Vervollständigungsfunktion. Das ist die gleiche Art von Funktionalität als wenn Sie die Tab-Taste benutzen, während Sie mit der Bash arbeiten.
Parameter-Liste
- function
-
Sie müssen den Namen einer existierenden Funktion angeben, die einen Teil einer Kommandozeile akzeptiert und ein Array möglicher Übereinstimmungen zurückgibt.
Rückgabewerte
Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.
add a note
User Contributed Notesreadline_completion_function
overshoot.tv
25-Jun-2009 07:07
25-Jun-2009 07:07
david at acz dot org
01-Feb-2005 08:08
01-Feb-2005 08:08
This function can simply return an array of all possible matches (regardless of the current user intput) and readline will handle the matching itself. This is likely to be much faster than attempting to handle partial matches in PHP.
john at weider dot cc
21-Sep-2002 04:32
21-Sep-2002 04:32
It seems that the registered function can accept 2 parameters, the first being the partial string, the second a number that when equal to zero indicates that the tab was hit on the first argument on the input. Otherwise it looks like the position within the string is returned.
This is neccessary information for processing shell command line input.