X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/0915d0b2e210701353ef30743d0df9c195f76295..c663fbea6851207b4e0ac3e362868c23b1494a46:/docs/latex/wx/inputstr.tex diff --git a/docs/latex/wx/inputstr.tex b/docs/latex/wx/inputstr.tex index daf42acc31..eb2c5f2249 100644 --- a/docs/latex/wx/inputstr.tex +++ b/docs/latex/wx/inputstr.tex @@ -34,7 +34,12 @@ Destructor. \func{char}{GetC}{\void} -Returns the first character in the input queue and removes it. +Returns the first character in the input queue and removes it, +blocking until it appears if necessary. + +\wxheading{Note} + +If EOF, return value is undefined and LastRead() will return 0 and not 1. \membersection{wxInputStream::Eof}\label{wxinputstreameof} @@ -42,6 +47,14 @@ Returns the first character in the input queue and removes it. Returns true if the end of stream has been reached. +\wxheading{Note} + +For some streams Eof() will not return true until an +attempt has been made to read past the end of the stream. +\helpref{LastRead()}{wxinputstreamlastread} +should be called after each read to check that +a non-zero number of bytes have been read. + \membersection{wxInputStream::LastRead}\label{wxinputstreamlastread} \constfunc{size\_t}{LastRead}{\void} @@ -54,6 +67,12 @@ Returns the last number of bytes read. Returns the first character in the input queue without removing it. +\wxheading{Note} + +Blocks until something appears in the stream if necessary, if nothing +ever does (i.e. EOF) LastRead() will return 0 (and the return value is +undefined), otherwise LastRead() returns 1. + \membersection{wxInputStream::Read} \func{wxInputStream\&}{Read}{\param{void *}{buffer}, \param{size\_t}{ size}} @@ -85,6 +104,16 @@ any states of the stream right away. Changes the stream current position. +\wxheading{Parameters} + +\docparam{pos}{Offset to seek to.} + +\docparam{mode}{One of {\bf wxFromStart}, {\bf wxFromEnd}, {\bf wxFromCurrent}.} + +\wxheading{Return value} + +The new stream position or wxInvalidOffset on error. + \membersection{wxInputStream::TellI} \constfunc{off\_t}{TellI}{\void}