OW_FileSystem.hpp

Go to the documentation of this file.

/*******************************************************************************
* Copyright (C) 2001-2004 Vintela, Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
*  - Redistributions of source code must retain the above copyright notice,
*    this list of conditions and the following disclaimer.
*
*  - Redistributions in binary form must reproduce the above copyright notice,
*    this list of conditions and the following disclaimer in the documentation
*    and/or other materials provided with the distribution.
*
*  - Neither the name of Vintela, Inc. nor the names of its
*    contributors may be used to endorse or promote products derived from this
*    software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL Vintela, Inc. OR THE CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*******************************************************************************/

#ifndef OW_FILESYSTEM_HPP_INCLUDE_GUARD_
#define OW_FILESYSTEM_HPP_INCLUDE_GUARD_
#include "OW_config.h"
#include "OW_Types.hpp"
#include "OW_ArrayFwd.hpp"
#include "OW_Exception.hpp"
#include "OW_CommonFwd.hpp"

#ifdef OW_HAVE_SYS_PARAM_H
#include <sys/param.h>
#endif
#ifndef MAXPATHLEN
#ifdef PATH_MAX
#define MAXPATHLEN PATH_MAX
#else
#define MAXPATHLEN 1024
#endif
#endif

namespace OW_NAMESPACE
{

OW_DECLARE_APIEXCEPTION(FileSystem, OW_COMMON_API)


namespace FileSystem
{
   OW_COMMON_API File openFile(const String& path);
   OW_COMMON_API File createFile(const String& path);
   OW_COMMON_API File openOrCreateFile(const String& path);
   OW_COMMON_API int changeFileOwner(const String& filename,
      const UserId& userId);
   OW_COMMON_API bool exists(const String& path);
#ifndef OW_WIN32

   OW_COMMON_API bool isExecutable(const String& path);
#endif

   OW_COMMON_API bool canRead(const String& path);
   OW_COMMON_API bool canWrite(const String& path);
#ifndef OW_WIN32

   OW_COMMON_API bool isLink(const String& path);
#endif

   OW_COMMON_API bool isDirectory(const String& path);
   OW_COMMON_API bool changeDirectory(const String& path);
   OW_COMMON_API bool makeDirectory(const String& path, int mode=0777);
   OW_COMMON_API bool getFileSize(const String& path, off_t& size);
   OW_COMMON_API bool removeDirectory(const String& path);
   OW_COMMON_API bool removeFile(const String& path);
   OW_COMMON_API bool getDirectoryContents(const String& path,
      StringArray& dirEntries);
   OW_COMMON_API bool renameFile(const String& oldFileName,
      const String& newFileName);
   OW_COMMON_API size_t read(const FileHandle& hdl, void* bfr, size_t numberOfBytes,
      off_t offset=-1L);
   OW_COMMON_API size_t write(FileHandle& hdl, const void* bfr,
      size_t numberOfBytes, off_t offset=-1L);
   OW_COMMON_API off_t seek(const FileHandle& hdl, off_t offset, int whence);
   OW_COMMON_API off_t tell(const FileHandle& hdl);
   OW_COMMON_API void rewind(const FileHandle& hdl);
   OW_COMMON_API int close(const FileHandle& hdl);
   OW_COMMON_API int flush(FileHandle& hdl);
   OW_COMMON_API void initRandomFile(const String& file) OW_DEPRECATED;
   OW_COMMON_API String getFileContents(const String& filename);
   
   OW_COMMON_API StringArray getFileLines(const String& filename);

   OW_COMMON_API String readSymbolicLink(const String& path);

   namespace Path
   {
      OW_COMMON_API String realPath(const String& path);

      OW_COMMON_API String dirname(const String& filename);

      OW_COMMON_API String getCurrentWorkingDirectory();


   } // end namespace Path

} // end namespace FileSystem

} // end namespace OW_NAMESPACE

#endif

---