Makefile.am Added cmTextTemplate.c/h cmText.c/h Added CmTextReplaceFirst()

Makefile.am

 cmHDR += src/libcm/cmSerialize.h src/libcm/cmSymTbl.h src/libcm/cmFileSys.h src/libcm/cmFile.h src/libcm/cmMem.h src/libcm/cmTime.h src/libcm/cmPgmOpts.h
 cmSRC += src/libcm/cmSerialize.c src/libcm/cmSymTbl.c src/libcm/cmFileSys.c src/libcm/cmFile.c src/libcm/cmMem.c src/libcm/cmTime.c src/libcm/cmPgmOpts.c
 
-cmHDR += src/libcm/cmLib.h src/libcm/cmText.h src/libcm/cmMath.h src/libcm/cmOp.h src/libcm/cmGnuPlot.h src/libcm/cmKeyboard.h
-cmSRC += src/libcm/cmLib.c src/libcm/cmText.c src/libcm/cmMath.c src/libcm/cmOp.c src/libcm/cmGnuPlot.c src/libcm/cmKeyboard.c
+cmHDR += src/libcm/cmLib.h src/libcm/cmText.h src/libcm/cmTextTemplate.h
+cmSRC += src/libcm/cmLib.c src/libcm/cmText.c src/libcm/cmTextTemplate.c
+
+cmHDR += src/libcm/cmMath.h src/libcm/cmOp.h src/libcm/cmGnuPlot.h src/libcm/cmKeyboard.h
+cmSRC += src/libcm/cmMath.c src/libcm/cmOp.c src/libcm/cmGnuPlot.c src/libcm/cmKeyboard.c
 
 cmHDR += src/libcm/cmLinkedHeap.h src/libcm/cmMallocDebug.h src/libcm/cmLex.h src/libcm/cmJson.h src/libcm/cmPrefs.h src/libcm/cmStack.h
 cmSRC += src/libcm/cmLinkedHeap.c src/libcm/cmMallocDebug.c src/libcm/cmLex.c src/libcm/cmJson.c src/libcm/cmPrefs.c src/libcm/cmStack.c

cmCtx.h

 // cmCtx_t is used to hold application supplied cmRpt_t, cmErr_t and
 // other global values for easy distribution throughtout a cm based application.
 //
-//  Most the cm components need at least an application supplied cmRpt_t function
+//  Most the libcm components need at least an application supplied cmRpt_t function
 //  to initialize their own internal cmErr_t error class.  Likewise classes which
 //  use a cmLHeapH_t based internal heap manager require application wide memory 
 // manager configuration information.  The cmCtx_t packages this information and
 // allows it to be easily distributed.  The applicaton and its constituent objects
 // then need only maintain and pass pointers to a single cmCtx_t object to have access to 
-// this all the global program information.
+// all the global program information.
 //)
 
 #ifndef cmCtx_h
   //(
 
   // cmCtx_t data type.
-typedef struct
-{
-  cmRpt_t  rpt;           //< Application supplied global reporter. This reporter is also use by \ref err.
-  cmErr_t  err;           //< Application error reporter which can be used to report errors prior to the client object being initialized to the point where it can use it's own cmErr_t.
-  unsigned guardByteCnt;  //< Guard byte count in use by \ref cmMallocDebug.h .
-  unsigned alignByteCnt;  //< Align byte count used by the \ref cmMallocDebug.h
-  unsigned mmFlags;       //< Initialization flags used by \ref cmMallocDebug.h.
-  void*    userDefPtr;    //< Application defined pointer.
-} cmCtx_t;
+  typedef struct
+  {
+    cmRpt_t  rpt;           // Application supplied global reporter. This reporter is also use by \ref err.
+    cmErr_t  err;           // Application error reporter which can be used to report errors prior to the client object being initialized to the point where it can use it's own cmErr_t.
+    unsigned guardByteCnt;  // Guard byte count in use by \ref cmMallocDebug.h .
+    unsigned alignByteCnt;  // Align byte count used by the \ref cmMallocDebug.h
+    unsigned mmFlags;       // Initialization flags used by \ref cmMallocDebug.h.
+    void*    userDefPtr;    // Application defined pointer.
+  } cmCtx_t;
 
   // cmCtx_t initialization function.
   void cmCtxSetup( 
-    cmCtx_t*         ctx,         //< The cmCtx_t to initialize.
-    const cmChar_t*  title,       //<  The cmCtx_t error label. See cmErrSetup().
-    cmRptPrintFunc_t prtFunc,     //<  The printFunc() to assign to the cmCtx_t.rpt.
-    cmRptPrintFunc_t errFunc,     //<  The errFunc() to assign to cmCtx_t.rpt.
-    void*            cbPtr,       //<  Callback data to use with prtFunc() and errFunc().
-    unsigned         guardByteCnt,//<  Guard byte count used to configure \ref cmMallocDebug.h
-    unsigned         alignByteCnt,//<  Align byte count used to configure \ref cmMallocDebug.h
-    unsigned         mmFlags      //<  Initialization flags used to configure \ref cmMallocDebug.h
+    cmCtx_t*         ctx,         // The cmCtx_t to initialize.
+    const cmChar_t*  title,       //  The cmCtx_t error label. See cmErrSetup().
+    cmRptPrintFunc_t prtFunc,     //  The printFunc() to assign to the cmCtx_t.rpt.
+    cmRptPrintFunc_t errFunc,     //  The errFunc() to assign to cmCtx_t.rpt.
+    void*            cbPtr,       //  Callback data to use with prtFunc() and errFunc().
+    unsigned         guardByteCnt,//  Guard byte count used to configure \ref cmMallocDebug.h
+    unsigned         alignByteCnt,//  Align byte count used to configure \ref cmMallocDebug.h
+    unsigned         mmFlags      //  Initialization flags used to configure \ref cmMallocDebug.h
                    );
   //)
   //}

cmLex.c

 
 cmRC_t cmLexFinal( cmLexH* hp )
 {
-  if( hp == NULL )
+  if( hp == NULL || cmLexIsValid(*hp)==false )
     return cmOkRC;
 
   cmLex* p = _cmLexHandleToPtr(*hp);
 // cmLexTest() gives a simple cmLex example.
 //)
 
-//[
+//(
 void cmLexTest( cmRpt_t* rpt)
 {
   cmChar_t buf[] =
-"123ident0\n\
- 123.456\n\
-ident0\n\
-0xa12+.2\n\
-// comment \n\
-/* block \n\
-comment */\
-\"quoted string\"\
-ident1\
-// last line comment\
-";
+"123ident0\n 123.456\nident0\n"
+"0xa12+.2\n"
+"// comment \n"
+"/* block \n"
+"comment */"
+"\"quoted string\""
+"ident1"
+"// last line comment";
 
   // initialize a lexer with a buffer of text
   cmLexH h = cmLexInit(buf,strlen(buf),
 
 }
 
-//]
+//)
 //}

cmMem.c

     // if no tracking recd was found
     if( rp == NULL )
       return cmErrMsg(&p->err,kMissingRecdMmRC,"Unable to locate a tracking record associated with released data area pointer:%p.",dataPtr);
+    /*
+    if( rp->uniqueId == 176690 )
+    {
+      cmErrMsg(&p->err,kOkMmRC,"Breakpoint for memory free id:%i.",rp->uniqueId);
+    }
+    */
 
     // if this block was already freed then this is a double free
     if( cmIsFlag(rp->flags,kFreedMmFl) )
    cmMm_t*  p          = _cmMmHandleToPtr(h); 
    unsigned newByteCnt = newEleCnt * newEleByteCnt;
    void*    ndp        = _cmMmAllocate(p,orgDataPtr,newByteCnt,flags);
+   
    /*
-   if( p->nextId == 1575 )
+   if( p->nextId == 189114 )
    {
      cmErrMsg(&p->err,kOkMmRC,"Breakpoint for memory allocation id:%i.",p->nextId);
    }
    */
+
    // if we are tracking changes
    if( cmIsFlag(p->flags,kTrackMmFl) )
    {

cmText.c

 cmChar_t* cmTextReplaceS( cmChar_t* s, const cmChar_t* t, unsigned tn, const cmChar_t* u )
 { return cmTextReplaceSN(s,t,tn,u,u==NULL ? 0 : strlen(u)); }
 
-cmChar_t* cmTextReplaceAll( cmChar_t* s, const cmChar_t* t, const cmChar_t* u )
+cmChar_t* _cmTextReplace( cmChar_t* s, const cmChar_t* t, const cmChar_t* u, unsigned n )
 {
-  // we will go into an endless loop if 't' is contained in 'u'.
-  assert( s!= NULL && t!=NULL && u!=NULL && strstr(u,t) == NULL );
+  // we will go into an endless loop if 't' is contained in 'u' and n > 1.
+  assert( s!= NULL && t!=NULL && u!=NULL && (n==1 || strstr(u,t) == NULL) );
 
   int       tn = strlen(t);
   cmChar_t* c  = NULL;
+  unsigned  i  = 0;
 
   while( (c = strstr(s,t)) != NULL ) 
   {
 
     assert(s!=NULL);
 
+    ++i;
+    if( n!=cmInvalidCnt && i>=n)
+      break;
+
   };
 
   return s;
 }
 
+cmChar_t* cmTextReplaceAll( cmChar_t* s, const cmChar_t* t, const cmChar_t* u )
+{ return _cmTextReplace(s,t,u,cmInvalidCnt); }
+
+cmChar_t* cmTextReplaceFirst( cmChar_t* s, const cmChar_t* t, const cmChar_t* u )
+{ return _cmTextReplace(s,t,u,1); }
+
 cmChar_t* cmTextInsertSN(  cmChar_t* s, const cmChar_t* t, const cmChar_t* u, unsigned un )
 {
   unsigned n = strlen(s)+1;

cmText.h

   
   // Replace all occurrences of t[] with u[] in s[].
   cmChar_t* cmTextReplaceAll( cmChar_t* s, const cmChar_t* t, const cmChar_t* u );
+  
+  // Replace the first occurence of t[] in s[] with u[].
+  cmChar_t* cmTextReplaceFirst( cmChar_t* s, const cmChar_t* t, const cmChar_t* u );
 
   // Insert u[un] at before t in s[].
   cmChar_t* cmTextInsertSN(  cmChar_t* s, const cmChar_t* t, const cmChar_t* u, unsigned un );