C/C++ User's Journal Synesis Software STLSoft - ... Robust, Lightweight, Cross-platform, Template Software ... UNIXSTL - Template Software for the UNIX Operating System WinSTL - where the Standard Template Library meets the Win32 API

Main Page   Modules   Alphabetical List   Compound List   File List   Compound Members   File Members   Related Pages  

recls.c++
[recls]

The recls C++ mapping. It resides within the recls::cpp namespace. More...

Compounds

class  DirectoryParts
 This class provides enumeration over the parts of a directory for a given file entry. More...

class  FileEntry
 This class represents a file search entry. More...

class  FileSearch
 This class provides functionality for executing a file search. More...


Typedefs

typedef std::string string_t
 string_t The string type to be used in the reclspp (recls::cpp) namespace


Functions

FileEntry::char_type const * c_str_ptr (FileEntry const &fe)
 String access shim.


Detailed Description

The recls C++ mapping. It resides within the recls::cpp namespace.

This mapping contains the classes - FileSearch, FileEntry, and DirectoryParts - which provide a simple C++ wrapping over the recls API, handling resource management, and providing easy-to-use object access to the search results.


Typedef Documentation

typedef std::string string_t
 

string_t The string type to be used in the reclspp (recls::cpp) namespace

Note:
By default string_t is defined to be std::string, but this can be overridden by specifying RECLS_CPP_STRING_HEADER, e.g. "mystring.h", and also defining RECLS_CPP_STRING_T, e.g. "my_string" which will be typedef'd to string_t


Function Documentation

FileEntry::char_type const* c_str_ptr FileEntry const &    fe [inline]
 

String access shim.

This returns a non-null null-terminated C-string of the given FileEntry's full path.

Parameters:
fe  The FileEntry instance whose path is to be returned
Note:
This fits the STLSoft shims concept, described in this Synesis Software White Paper, and featured in the article "Generalised String Manipulation: Access Shims and Type-tunnelling", in the August 2003 issue of C/C++ User's Journal.

recls Library documentation © Synesis Software Pty Ltd, 2001-2003