X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/70a7bd90f9bdafd5ffbc89fd0b79b9e900d7dd22..d9605e634b503651fd349a3d2c6781b2407ea273:/docs/latex/wx/ffile.tex diff --git a/docs/latex/wx/ffile.tex b/docs/latex/wx/ffile.tex index 72a8fd768f..789a462ada 100644 --- a/docs/latex/wx/ffile.tex +++ b/docs/latex/wx/ffile.tex @@ -6,7 +6,7 @@ %% Created: 14.01.02 (extracted from file.tex) %% RCS-ID: $Id$ %% Copyright: (c) Vadim Zeitlin -%% License: wxWidgets license +%% License: wxWindows license %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{\class{wxFFile}}\label{wxffile} @@ -41,7 +41,7 @@ None. Default constructor. -\func{}{wxFFile}{\param{const char*}{ filename}, \param{const char*}{ mode = "r"}} +\func{}{wxFFile}{\param{const wxString\&}{ filename}, \param{const wxString\&}{ mode = "r"}} Opens a file with the given mode. As there is no way to return whether the operation was successful or not from the constructor you should test the @@ -127,7 +127,7 @@ the file is not opened. \membersection{wxFFile::Error}\label{wxffileerror} -Returns \true if an error has occured on this file, similar to the standard +Returns \true if an error has occurred on this file, similar to the standard \texttt{ferror()} function. Please note that this method may only be called for opened files and may crash @@ -145,6 +145,24 @@ if the file is not opened. Flushes the file and returns \true on success. +\membersection{wxFFile::GetKind}\label{wxffilegetfilekind} + +\constfunc{wxFileKind}{GetKind}{\void} + +Returns the type of the file. Possible return values are: + +\begin{verbatim} +enum wxFileKind +{ + wxFILE_KIND_UNKNOWN, + wxFILE_KIND_DISK, // a file supporting seeking to arbitrary offsets + wxFILE_KIND_TERMINAL, // a tty + wxFILE_KIND_PIPE // a pipe +}; + +\end{verbatim} + + \membersection{wxFFile::IsOpened}\label{wxffileisopened} \constfunc{bool}{IsOpened}{\void} @@ -162,7 +180,7 @@ Returns the length of the file. \membersection{wxFFile::Open}\label{wxffileopen} -\func{bool}{Open}{\param{const char*}{ filename}, \param{const char*}{ mode = "r"}} +\func{bool}{Open}{\param{const wxString\&}{ filename}, \param{const wxString\&}{ mode = "r"}} Opens the file, returning \true if successful. @@ -190,6 +208,24 @@ Reads the specified number of bytes into a buffer, returning the actual number r The number of bytes read. +\membersection{wxFFile::ReadAll}\label{wxffilereadall} + +\func{bool}{ReadAll}{\param{wxString *}{ str}, \param{const wxMBConv\&}{ conv = wxConvAuto()}} + +Reads the entire contents of the file into a string. + +\wxheading{Parameters} + +\docparam{str}{String to read data into.} + +\docparam{conv}{Conversion object to use in Unicode build; by default supposes +that file contents is encoded in UTF-8.} + +\wxheading{Return value} + +\true if file was read successfully, \false otherwise. + + \membersection{wxFFile::Seek}\label{wxffileseek} \func{bool}{Seek}{\param{wxFileOffset }{ofs}, \param{wxSeekMode }{mode = wxFromStart}} @@ -241,7 +277,7 @@ Number of bytes written. \membersection{wxFFile::Write}\label{wxffilewrites} -\func{bool}{Write}{\param{const wxString\& }{s}, \param{wxMBConv\&}{ conv = wxConvUTF8}} +\func{bool}{Write}{\param{const wxString\& }{s}, \param{const wxMBConv\&}{ conv = wxConvAuto()}} Writes the contents of the string to the file, returns \true on success.