You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
97 lines
2.4 KiB
97 lines
2.4 KiB
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
file Copyright.txt or https://cmake.org/licensing#kwsys for details. */
|
|
#ifndef @KWSYS_NAMESPACE@_Directory_hxx
|
|
#define @KWSYS_NAMESPACE@_Directory_hxx
|
|
|
|
#include <@KWSYS_NAMESPACE@/Configure.h>
|
|
#include <@KWSYS_NAMESPACE@/Status.hxx>
|
|
|
|
#include <cstddef>
|
|
#include <string>
|
|
|
|
namespace @KWSYS_NAMESPACE@ {
|
|
|
|
class DirectoryInternals;
|
|
|
|
/** \class Directory
|
|
* \brief Portable directory/filename traversal.
|
|
*
|
|
* Directory provides a portable way of finding the names of the files
|
|
* in a system directory.
|
|
*
|
|
* Directory currently works with Windows and Unix operating systems.
|
|
*/
|
|
class @KWSYS_NAMESPACE@_EXPORT Directory
|
|
{
|
|
public:
|
|
Directory();
|
|
Directory(Directory&& other);
|
|
Directory(const Directory&) = delete;
|
|
Directory& operator=(const Directory&) = delete;
|
|
Directory& operator=(Directory&& other);
|
|
bool operator==(const Directory&) = delete;
|
|
~Directory();
|
|
|
|
/**
|
|
* Load the specified directory and load the names of the files
|
|
* in that directory.
|
|
*/
|
|
Status Load(std::string const&, std::string* errorMessage = nullptr);
|
|
|
|
/**
|
|
* Return the number of files in the current directory.
|
|
*/
|
|
unsigned long GetNumberOfFiles() const;
|
|
|
|
/**
|
|
* Return the number of files in the specified directory.
|
|
* A higher performance static method.
|
|
*/
|
|
static unsigned long GetNumberOfFilesInDirectory(
|
|
const std::string&, std::string* errorMessage = nullptr);
|
|
|
|
/**
|
|
* Return the file at the given index, the indexing is 0 based
|
|
*/
|
|
const char* GetFile(unsigned long) const;
|
|
|
|
/**
|
|
* Return the name of the file at the given 0-based index.
|
|
*/
|
|
std::string const& GetFileName(std::size_t i) const;
|
|
|
|
/**
|
|
* Return the absolute path to the file at the given 0-based index.
|
|
*/
|
|
std::string GetFilePath(std::size_t i) const;
|
|
|
|
/**
|
|
* Return whether the file at the given 0-based index is a directory.
|
|
*/
|
|
bool FileIsDirectory(std::size_t i) const;
|
|
|
|
/**
|
|
* Return whether the file at the given 0-based index is a symlink.
|
|
*/
|
|
bool FileIsSymlink(std::size_t i) const;
|
|
|
|
/**
|
|
* Return the path to Open'ed directory
|
|
*/
|
|
const char* GetPath() const;
|
|
|
|
/**
|
|
* Clear the internal structure. Used internally at beginning of Load(...)
|
|
* to clear the cache.
|
|
*/
|
|
void Clear();
|
|
|
|
private:
|
|
// Private implementation details.
|
|
DirectoryInternals* Internal;
|
|
}; // End Class: Directory
|
|
|
|
} // namespace @KWSYS_NAMESPACE@
|
|
|
|
#endif
|