# coyote: CGAPPENDTOFILENAME

- coyote/Utilities
- [Source code]

Description

      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.