cmFileSys.h/c: Added cmFileSysGenFn().

cmFileSys.c

 #include "cmMallocDebug.h"
 #include "cmLinkedHeap.h"
 #include "cmFileSys.h"
+#include "cmText.h"
 
 #include <sys/stat.h>
 #include <errno.h>
   cmLHeapFree(p->heapH, (void*)fn); 
 }
 
+cmFsRC_t cmFileSysGenFn( cmFileSysH_t h, const cmChar_t* dir, const cmChar_t* prefixStr, const cmChar_t* extStr, const cmChar_t** fnPtr )
+{
+  cmFsRC_t rc            = kOkFsRC;
+  cmFs_t*  p             = _cmFileSysHandleToPtr(h);
+  unsigned maxAttemptCnt = 0xffff;
+
+  *fnPtr = NULL;
+
+  assert(dir != NULL);
+
+  if( prefixStr == NULL )
+    prefixStr = "";
+
+  if( extStr == NULL )
+    extStr = "";
+
+  if( !cmFileSysIsDir(h,dir) )
+    return cmErrMsg(&p->err,kOpenDirFailFsRC,"File name generation failed because the directory '%s' does not exist.",cmStringNullGuard(dir));
+
+  unsigned i;
+  for(i=0; *fnPtr==NULL; ++i)
+  {
+    cmChar_t* fn = cmTsPrintfP(NULL,"%s%i",prefixStr,i);
+
+    const cmChar_t* path = cmFileSysMakeFn(h,dir,fn,extStr,NULL );
+    
+    if( !cmFileSysIsFile(h,path) )
+      *fnPtr = cmMemAllocStr(path);
+
+    cmFileSysFreeFn(h,path);
+    cmMemFree(fn);
+
+    if( i == maxAttemptCnt )
+      return cmErrMsg(&p->err,kGenFileFailFsRC,"File name generation failed because a suitable file name could not be found after %i attempts.",maxAttemptCnt);
+  };
+
+  return rc;
+}
+
 cmFsRC_t    cmFileSysMkDir( cmFileSysH_t h, const cmChar_t* dir )
 {
   cmFs_t* p = _cmFileSysHandleToPtr(h);
 void                 cmFsFreeFn(  const cmChar_t* fn )
 { cmFileSysFreeFn(_cmFsH, fn); }
 
+cmFsRC_t             cmFsGenFn( const cmChar_t* dir, const cmChar_t* prefixStr, const cmChar_t* extStr, const cmChar_t** fnPtr )
+{ return cmFileSysGenFn(_cmFsH,dir,prefixStr,extStr,fnPtr); }
+
 cmFsRC_t             cmFsMkDir( const cmChar_t* dir )
 { return cmFileSysMkDir(_cmFsH,dir); }
 

cmFileSys.h

     kSysErrFsRC,
     kOsxFailFsRC,
     kLinuxFailFsRC,
-    kInvalidDirFsRC
+    kInvalidDirFsRC,
+    kGenFileFailFsRC
   };
 
 
   // Release the file name created through an earlier call to cmFileSysMakeFn().
   void            cmFileSysFreeFn( cmFileSysH_t h, const cmChar_t* fn );
 
+  // Generate an unused filename in the directory 'dir' beginning with the prefix 'prefixStr'.
+  // The returned file name will have the format: <dir>/<prefixStr>nnnn.<extStr> where
+  // nnn represents 1 or more digits.  The returned string must be released with a 
+  // call to cmMemFree().
+  cmFsRC_t cmFileSysGenFn( cmFileSysH_t h, const cmChar_t* dir, const cmChar_t* prefixStr, const cmChar_t* extStr, const cmChar_t** fnPtr );
+
   // Create a directory - where the entire path already exists except for the 
   // final directory.
   cmFsRC_t    cmFileSysMkDir( cmFileSysH_t h, const cmChar_t* dir );
   // Release the memory assoicated with a cmFileSysDirEntry_t array returned from an earlier call to cmFileSysDirEntries().
   void cmFileSysDirFreeEntries( cmFileSysH_t h, cmFileSysDirEntry_t* p );
 
+
   // Return the last error code generated by the file system.
   cmFsRC_t cmFileSysErrorCode( cmFileSysH_t h );
 
   const cmChar_t* cmFsVMakeFn( const cmChar_t* dirPrefix, const cmChar_t* fn, const cmChar_t* ext, va_list vl );
   const cmChar_t* cmFsMakeFn(  const cmChar_t* dirPrefix, const cmChar_t* fn, const cmChar_t* ext, ... );
   void            cmFsFreeFn(  const cmChar_t* fn );
+  cmFsRC_t        cmFsGenFn(  const cmChar_t* dir, const cmChar_t* prefixStr, const cmChar_t* extStr, const cmChar_t** fnPtr );
+
 
   cmFsRC_t        cmFsMkDir( const cmChar_t* dir );
   cmFsRC_t        cmFsMkDirAll( const cmChar_t* dir );