gfile.h

//========================================================================
//
// gfile.h
//
// Miscellaneous file and directory name manipulation.
//
// Copyright 1996-2002 Glyph & Cog, LLC
//
//========================================================================
 
#ifndef GFILE_H
#define GFILE_H
 
#include <aconf.h>
#include <stdio.h>
#include <stdlib.h>
#include <stddef.h>
#if defined(WIN32)
#  include <sys/stat.h>
#  ifdef FPTEX
#    include <win32lib.h>
#  else
#    include <windows.h>
#  endif
#elif defined(ACORN)
#elif defined(MACOS)
#  include <ctime.h>
#else
#  include <unistd.h>
#  include <sys/types.h>
#  ifdef VMS
#    include "vms_dirent.h"
#  elif HAVE_DIRENT_H
#    include <dirent.h>
#    define NAMLEN(d) strlen((d)->d_name)
#  else
#    define dirent direct
#    define NAMLEN(d) (d)->d_namlen
#    if HAVE_SYS_NDIR_H
#      include <sys/ndir.h>
#    endif
#    if HAVE_SYS_DIR_H
#      include <sys/dir.h>
#    endif
#    if HAVE_NDIR_H
#      include <ndir.h>
#    endif
#  endif
#endif
#include "gtypes.h"
 
class GString;
 
//------------------------------------------------------------------------
 
// Get home directory path.
extern GString *getHomeDir();
 
// Get current directory.
extern GString *getCurrentDir();
 
// Append a file name to a path string.  <path> may be an empty
// string, denoting the current directory).  Returns <path>.
extern GString *appendToPath(GString *path, const char *fileName);
 
// Grab the path from the front of the file name.  If there is no
// directory component in <fileName>, returns an empty string.
extern GString *grabPath(const char *fileName);
 
// Is this an absolute path or file name?
extern GBool isAbsolutePath(const char *path);
 
// Make this path absolute by prepending current directory (if path is
// relative) or prepending user's directory (if path starts with '~').
extern GString *makePathAbsolute(GString *path);
 
// Get the modification time for <fileName>.  Returns 0 if there is an
// error.
extern time_t getModTime(const char *fileName);
 
// Create a temporary file and open it for writing.  If <ext> is not
// NULL, it will be used as the file name extension.  Returns both the
// name and the file pointer.  For security reasons, all writing
// should be done to the returned file pointer; the file may be
// reopened later for reading, but not for writing.  The <mode> string
// should be "w" or "wb".  Returns true on success.
extern GBool openTempFile(GString **name, FILE **f, const char *mode);//, char *ext);
 
// Execute <command>.  Returns true on success.
extern GBool executeCommand(const char *cmd);
 
// Just like fgets, but handles Unix, Mac, and/or DOS end-of-line
// conventions.
extern char *getLine(char *buf, int size, FILE *f);
 
//------------------------------------------------------------------------
// GDir and GDirEntry
//------------------------------------------------------------------------
 
class GDirEntry {
public:
 
  GDirEntry(const char *dirPath, const char *nameA, GBool doStat);
  ~GDirEntry();
  GString *getName() { return name; }
  GBool isDir() { return dir; }
 
private:
 
  GString *name;        // dir/file name
  GBool dir;            // is it a directory?
};
 
class GDir {
public:
 
  GDir(const char *name, GBool doStatA = gTrue);
  ~GDir();
  GDirEntry *getNextEntry();
  void rewind();
 
private:
 
  GString *path;        // directory path
  GBool doStat;         // call stat() for each entry?
#if defined(WIN32)
  WIN32_FIND_DATA ffd;
  HANDLE hnd;
#elif defined(ACORN)
#elif defined(MACOS)
#else
  DIR *dir;         // the DIR structure from opendir()
#ifdef VMS
  GBool needParent;     // need to return an entry for [-]
#endif
#endif
};
 
#endif