Read the output stream of an ExecFuture one line at a time. This abstraction allows you to process large inputs without holding them in memory. If you know your inputs fit in memory, it is generally more efficient (and certainly simpler) to read the entire input and explode() it. For more information, see LinesOfALarge. See also LinesOfALargeFile for a similar abstraction that works on files.
$future = new ExecFuture('hg log ...');
foreach (new LinesOfALargeExecFuture($future) as $line) {
// ...
}If the subprocess exits with an error, a CommandException will be thrown.
On destruction, this class terminates the subprocess if it has not already exited.
To construct, pass an ExecFuture.
| ExecFuture | $future | Future to wrap. |
| this | //Implicit.// |
On destruction, we terminate the subprocess if it hasn't exited already.
| void |
The PHP foreach() construct calls rewind() once, so we allow the first rewind(), without effect. Subsequent rewinds mean misuse.
| void |
Read more data from the subprocess.
| string | Bytes read from stdout. |