CSimpleGlobTempl< SOCHAR > Class Template Reference

Implementation of the SimpleGlob class. More...

#include <SimpleGlob.h>

List of all members.

Public Member Functions

 CSimpleGlobTempl (unsigned int a_uiFlags=0, int a_nReservedSlots=0)
 Initialize the class.
 ~CSimpleGlobTempl ()
 Deallocate all memory buffers.
int Init (unsigned int a_uiFlags=0, int a_nReservedSlots=0)
 Initialize (or re-initialize) the class in preparation for adding new filespecs.
int Add (const SOCHAR *a_pszFileSpec)
 Add a new filespec to the glob.
int Add (int a_nCount, const SOCHAR *const *a_rgpszFileSpec)
 Add an array of filespec to the glob.
int FileCount () const
 Return the number of files in the argv array.
SOCHAR ** Files ()
 Return the full argv array.
SOCHAR * File (int n)
 Return the a single file.


Detailed Description

template<class SOCHAR>
class CSimpleGlobTempl< SOCHAR >

Implementation of the SimpleGlob class.

Definition at line 440 of file SimpleGlob.h.


Constructor & Destructor Documentation

template<class SOCHAR>
CSimpleGlobTempl< SOCHAR >::CSimpleGlobTempl ( unsigned int  a_uiFlags = 0,
int  a_nReservedSlots = 0 
) [inline]

Initialize the class.

Parameters:
a_uiFlags Combination of SG_GLOB flags.
a_nReservedSlots Number of slots in the argv array that should be reserved. In the returned array these slots argv[0] ... argv[a_nReservedSlots-1] will be left empty for the caller to fill in.

Definition at line 558 of file SimpleGlob.h.

References CSimpleGlobTempl< SOCHAR >::Init().


Member Function Documentation

template<class SOCHAR>
int CSimpleGlobTempl< SOCHAR >::Init ( unsigned int  a_uiFlags = 0,
int  a_nReservedSlots = 0 
) [inline]

Initialize (or re-initialize) the class in preparation for adding new filespecs.

All existing files are cleared. Note that allocated memory is only deallocated at object destruction.

Parameters:
a_uiFlags Combination of SG_GLOB flags.
a_nReservedSlots Number of slots in the argv array that should be reserved. In the returned array these slots argv[0] ... argv[a_nReservedSlots-1] will be left empty for the caller to fill in.

Definition at line 580 of file SimpleGlob.h.

Referenced by CSimpleGlobTempl< SOCHAR >::CSimpleGlobTempl().

template<class SOCHAR>
int CSimpleGlobTempl< SOCHAR >::Add ( const SOCHAR *  a_pszFileSpec  )  [inline]

Add a new filespec to the glob.

The filesystem will be immediately scanned for all matching files and directories and they will be added to the glob.

Parameters:
a_pszFileSpec Filespec to add to the glob.
Returns:
SG_SUCCESS Matching files were added to the glob.

SG_ERR_NOMATCH Nothing matched the pattern. To ignore this error compare return value to >= SG_SUCCESS.

SG_ERR_MEMORY Out of memory failure.

SG_ERR_FAILURE General failure.

Definition at line 605 of file SimpleGlob.h.

Referenced by CSimpleGlobTempl< SOCHAR >::Add().

template<class SOCHAR>
int CSimpleGlobTempl< SOCHAR >::Add ( int  a_nCount,
const SOCHAR *const *  a_rgpszFileSpec 
) [inline]

Add an array of filespec to the glob.

The filesystem will be immediately scanned for all matching files and directories in each filespec and they will be added to the glob.

Parameters:
a_nCount Number of filespec in the array.
a_rgpszFileSpec Array of filespec to add to the glob.
Returns:
SG_SUCCESS Matching files were added to the glob.

SG_ERR_NOMATCH Nothing matched the pattern. To ignore this error compare return value to >= SG_SUCCESS.

SG_ERR_MEMORY Out of memory failure.

SG_ERR_FAILURE General failure.

Definition at line 687 of file SimpleGlob.h.

References CSimpleGlobTempl< SOCHAR >::Add().


The documentation for this class was generated from the following file:

Generated on Wed Jul 9 10:51:18 2008 for SimpleOpt by  doxygen 1.5.6