diff options
| author | Junio C Hamano <gitster@pobox.com> | 2011-05-21 21:05:51 (GMT) |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2011-05-26 23:47:15 (GMT) |
| commit | 4ae6670444388f5ba68850e42a93af4019922c26 (patch) | |
| tree | a065ece4a58a8f4030e77a8c26ae1391a48ae40c /convert.h | |
| parent | b6691092d707860019bbab80eaaf9173ada10586 (diff) | |
| download | git-4ae6670444388f5ba68850e42a93af4019922c26.zip git-4ae6670444388f5ba68850e42a93af4019922c26.tar.gz git-4ae6670444388f5ba68850e42a93af4019922c26.tar.bz2 | |
stream filter: add "no more input" to the filters
Some filters may need to buffer the input and look-ahead inside it
to decide what to output, and they may consume more than zero bytes
of input and still not produce any output. After feeding all the
input, pass NULL as input as keep calling stream_filter() to let
such filters know there is no more input coming, and it is time for
them to produce the remaining output based on the buffered input.
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'convert.h')
| -rw-r--r-- | convert.h | 7 |
1 files changed, 7 insertions, 0 deletions
@@ -57,6 +57,13 @@ extern int is_null_stream_filter(struct stream_filter *); * Use as much input up to *isize_p and fill output up to *osize_p; * update isize_p and osize_p to indicate how much buffer space was * consumed and filled. Return 0 on success, non-zero on error. + * + * Some filters may need to buffer the input and look-ahead inside it + * to decide what to output, and they may consume more than zero bytes + * of input and still not produce any output. After feeding all the + * input, pass NULL as input and keep calling this function, to let + * such filters know there is no more input coming and it is time for + * them to produce the remaining output based on the buffered input. */ extern int stream_filter(struct stream_filter *, const char *input, size_t *isize_p, |