PortableDirs.h

/* PortableDirs.h */
/* $Id: PortableDirs.h,v 1.13 2006/10/18 10:21:07 vlad Exp $ */

#ifndef __PortableDirs_h

#define __PortableDirs_h

#include <dirent.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <mix/Types.h>
#include <mix/Exceptions.h>

/*************************************************************
 * Portable directory toolkit
 * Parts:
 * -- portable directory entry structure;
 * -- OS-independent dir-scan function.
 *************************************************************/

#ifdef _AIX
#include <limits.h>
#   define MAX_DIR_NAME _D_NAME_MAX
#endif /* _AIX */
#ifdef sparc
#   define MAX_DIR_NAME 255
#endif /* sparc */
#ifdef linux
#   define MAX_DIR_NAME 255
#endif /* linux */
#ifdef bsd
#   define MAX_DIR_NAME MAXNAMLEN
#endif /* bsd */

/* For UNIX only */
#define PATH_DELIM_CHAR     '/'


#ifdef __cplusplus
extern "C"
{
#endif /* __cplusplus */

typedef struct
{
  const char    *dir;           /* pointer at the directory of file */
  const char    *name;          /* file name */
  const char    *path;          /* full file path */
  struct stat   *desc;          /* pointer at the file description */

}   PortDirEntry;


typedef struct dir_entry_item
{
  struct dir_entry_item *next;      /* pointer to the next item */
  char      name[MAX_DIR_NAME+1];   /* file name */
  struct stat   buf;            /* file description */

}   DirEntryItem;


typedef Logic (*PortDirCB)(const PortDirEntry* pDirEnt,
               void* pUserData);

ErrCode DirIter (const char* szDirPath,
         PortDirCB forEachEntry,
         void* pUserData);


DirEntryItem*   BuildDirList (const char* szDirPath,
                  PortDirCB ifSelected,
                  int* pItemsCount,
                  void* pUserData);

void        DestroyDirList (DirEntryItem* head);


int     AutoCountedFileName (const char* szDirPath,
                     const char* szTemplateFileName,
                     char** pszResultFileName,
                     int nDig);


char*       BuildFilePath (const char* szDirPath,
                   const char* szFileName);


/*************************************************************
 * Build path from directory and file name in given buffer or
 * dynamically allocated.
 *************************************************************/
char*       BuildFilePathHere (const char* szDirPath,
                   const char* szFileName,
                   char* szFilePath);

char*       BuildFilePathVa (const char* szPart1, ...);


/*************************************************************
 *
 * Custom file selectors
 *
 *************************************************************/

Logic   SelectDirs (const PortDirEntry* pDirEnt, void* pUserData);
Logic   SelectNonHiddenDirs (const PortDirEntry* pDirEnt, void* pUserData);
Logic   SelectFiles (const PortDirEntry* pDirEnt, void* pUserData);
Logic   SelectMtabs (const PortDirEntry* pDirEnt, void* pUserData);
Logic   SelectDRSdats (const PortDirEntry* pDirEnt, void* pUserData);
Logic   SelectWildcard (const PortDirEntry* pDirEnt, void* pFileMask);

Logic   SelectDbTables (const PortDirEntry* pDirEnt, void* pDbNameMask);


#ifdef __cplusplus
};
#endif /* __cplusplus */

#endif  /* PortableDirs.h */