The purpose of this routine is to allow the user append text to the end of the
  root name of an absolute file name. The text is appended to the end of the root
  name (see `cgRootName`) and before the final file extension.

Categories

---

    Utilities
   

Returns

---

      The appended filename.
     

Params

---

    filename: in, required, type=string
        This file name the text is to be to be appended to. It may be a relative or absolute path
        name to a file.
    thetext: in, required, type=string
        The text to append to the end of the file root name.
       

Examples

---

    Append "processed" to a filename::
      IDL> thePath = "C:\rsi\idl7.8\lib\jester.img"
      IDL> outFileName = cgAppendToFilename(thePath, '_processed')
      IDL> Print, outFileName
            C:\rsi\idl7.8\lib\jester_processed.img
     

Author

---

    FANNING SOFTWARE CONSULTING::
      David W. Fanning
      1645 Sheely Drive
      Fort Collins, CO 80526 USA
      Phone: 970-221-0438
      E-mail: david@idlcoyote.com
      Coyote's Guide to IDL Programming: http://www.idlcoyote.com

History

---

    Change History::
        Written by: David W. Fanning, 19 September 2012.

Copyright

---

    Copyright (c)2012, Fanning Software Consulting, Inc.