X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4afd752902ae7c44f4b3dc2edb11d7c24f95ed54..f94a790dafd54c290618c97cb3d4feffc400fd15:/docs/latex/wx/dir.tex diff --git a/docs/latex/wx/dir.tex b/docs/latex/wx/dir.tex index 676d62c3b2..d92f7e95f7 100644 --- a/docs/latex/wx/dir.tex +++ b/docs/latex/wx/dir.tex @@ -1,8 +1,13 @@ -% -% automatically generated by HelpGen from -% include\wx\dir.h at 11/Dec/99 00:55:30 -% - +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Name: dir.tex +%% Purpose: wxDir documentation +%% Author: Vadim Zeitlin +%% Modified by: +%% Created: 04.04.00 +%% RCS-ID: $Id$ +%% Copyright: (c) Vadim Zeitlin +%% License: wxWidgets license +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{\class{wxDir}}\label{wxdir} @@ -10,6 +15,10 @@ wxDir is a portable equivalent of Unix {open/read/close}dir functions which allow enumerating of the files in a directory. wxDir allows enumerate files as well as directories. +wxDir also provides a flexible way to enumerate files recursively using +\helpref{Traverse}{wxdirtraverse} or a simpler +\helpref{GetAllFiles}{wxdirgetallfiles} function. + Example of use: \begin{verbatim} @@ -41,8 +50,8 @@ No base class \wxheading{Constants} -These flags define what kind of filenames is included in the list of files -enumerated by GetFirst/GetNext +These flags define what kind of filename is included in the list of files +enumerated by GetFirst/GetNext. {\small \begin{verbatim} @@ -54,7 +63,7 @@ enum wxDIR_DOTDOT = 0x0008, // include '.' and '..' // by default, enumerate everything except '.' and '..' - wxDIR_DEFAULT = wxDIR\_FILES | wxDIR\_DIRS | wxDIR\_HIDDEN + wxDIR_DEFAULT = wxDIR_FILES | wxDIR_DIRS | wxDIR_HIDDEN } \end{verbatim} } @@ -65,12 +74,6 @@ enum \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxDir::Exists}\label{wxdirexists} - -\func{static bool}{Exists}{\param{const wxString\& }{dir}} - -Test for existence of a directory with the given name - \membersection{wxDir::wxDir}\label{wxdirwxdir} \func{}{wxDir}{\void} @@ -82,33 +85,52 @@ Default constructor, use \helpref{Open()}{wxdiropen} afterwards. Opens the directory for enumeration, use \helpref{IsOpened()}{wxdirisopened} to test for errors. + \membersection{wxDir::\destruct{wxDir}}\label{wxdirdtor} \func{}{\destruct{wxDir}}{\void} -Destructor cleans up the associated ressources. It is not virtual and so this +Destructor cleans up the associated resources. It is not virtual and so this class is not meant to be used polymorphically. -\membersection{wxDir::Open}\label{wxdiropen} -\func{bool}{Open}{\param{const wxString\& }{dir}} +\membersection{wxDir::Exists}\label{wxdirexists} -Open the directory for enumerating, returns TRUE on success or FALSE if an -error occured. +\func{static bool}{Exists}{\param{const wxString\& }{dir}} -\membersection{wxDir::IsOpened}\label{wxdirisopened} +Test for existence of a directory with the given name -\constfunc{bool}{IsOpened}{\void} -Returns TRUE if the directory was successfully opened by a previous call to -\helpref{Open}{wxdiropen}. +\membersection{wxDir::GetAllFiles}\label{wxdirgetallfiles} + +\func{static size\_t}{GetAllFiles}{\param{const wxString\& }{dirname}, \param{wxArrayString *}{files}, \param{const wxString\& }{filespec = wxEmptyString}, \param{int }{flags = wxDIR\_DEFAULT}} + +The function appends the names of all the files under directory {\it dirname} +to the array {\it files} (note that its old contents is preserved). Only files +matching the {\it filespec} are taken, with empty spec matching all the files. + +The {\it flags} parameter should always include {\tt wxDIR\_FILES} or the array +would be unchanged and should include {\tt wxDIR\_DIRS} flag to recurse into +subdirectories (both flags are included in the value by default). + +See also: \helpref{Traverse}{wxdirtraverse} + \membersection{wxDir::GetFirst}\label{wxdirgetfirst} \constfunc{bool}{GetFirst}{\param{wxString* }{filename}, \param{const wxString\& }{filespec = wxEmptyString}, \param{int }{flags = wxDIR\_DEFAULT}} Start enumerating all files matching {\it filespec} (or all files if it is -empty) and flags, return TRUE on success. +empty) and flags, return true on success. + + +\membersection{wxDir::GetName}\label{wxdirgetname} + +\constfunc{wxString}{GetName}{\void} + +Returns the name of the directory itself. The returned string does not have the +trailing path separator (slash or backslash). + \membersection{wxDir::GetNext}\label{wxdirgetnext} @@ -117,3 +139,60 @@ empty) and flags, return TRUE on success. Continue enumerating files satisfying the criteria specified by the last call to \helpref{GetFirst}{wxdirgetfirst}. + +\membersection{wxDir::HasFiles}\label{wxdirhasfiles} + +\func{bool}{HasFiles}{\param{const wxString\& }{filespec = wxEmptyString}} + +Returns {\tt true} if the directory contains any files matching the given +{\it filespec}. If {\it filespec} is empty, look for any files at all. In any +case, even hidden files are taken into account. + + +\membersection{wxDir::HasSubDirs}\label{wxdirhassubdirs} + +\func{bool}{HasSubDirs}{\param{const wxString\& }{dirspec = wxEmptyString}} + +Returns {\tt true} if the directory contains any subdirectories (if a non +empty {\it filespec} is given, only check for directories matching it). +The hidden subdirectories are taken into account as well. + + +\membersection{wxDir::IsOpened}\label{wxdirisopened} + +\constfunc{bool}{IsOpened}{\void} + +Returns true if the directory was successfully opened by a previous call to +\helpref{Open}{wxdiropen}. + + +\membersection{wxDir::Open}\label{wxdiropen} + +\func{bool}{Open}{\param{const wxString\& }{dir}} + +Open the directory for enumerating, returns true on success or false if an +error occurred. + + +\membersection{wxDir::Traverse}\label{wxdirtraverse} + +\func{size\_t}{Traverse}{\param{wxDirTraverser\& }{sink}, \param{const wxString\& }{filespec = wxEmptyString}, \param{int }{flags = wxDIR\_DEFAULT}} + +Enumerate all files and directories under the given directory recursively +calling the element of the provided \helpref{wxDirTraverser}{wxdirtraverser} +object for each of them. + +More precisely, the function will really recurse into subdirectories if +{\it flags} contains {\tt wxDIR\_DIRS} flag. It will ignore the files (but +still possibly recurse into subdirectories) if {\tt wxDIR\_FILES} flag is +given. + +For each found directory, \helpref{sink.OnDir()}{wxdirtraverserondir} is called +and \helpref{sink.OnFile()}{wxdirtraverseronfile} is called for every file. +Depending on the return value, the enumeration may continue or stop. + +The function returns the total number of files found or {\tt (size\_t)-1} on +error. + +See also: \helpref{GetAllFiles}{wxdirgetallfiles} +