src/filename_setext.cxx

   1 //
   2 // "$Id: filename_setext.cxx 8063 2010-12-19 21:20:10Z matt $"
   3 //
   4 // Filename extension routines for the Fast Light Tool Kit (FLTK).
   5 //
   6 // Copyright 1998-2010 by Bill Spitzak and others.
   7 //
   8 // This library is free software; you can redistribute it and/or
   9 // modify it under the terms of the GNU Library General Public
  10 // License as published by the Free Software Foundation; either
  11 // version 2 of the License, or (at your option) any later version.
  12 //
  13 // This library is distributed in the hope that it will be useful,
  14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16 // Library General Public License for more details.
  17 //
  18 // You should have received a copy of the GNU Library General Public
  19 // License along with this library; if not, write to the Free Software
  20 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  21 // USA.
  22 //
  23 // Please report all bugs and problems on the following page:
  24 //
  25 //     http://www.fltk.org/str.php
  26 //
  27
  28 // Replace .ext with new extension
  29
  30 #include <FL/filename.H>
  31 #include "flstring.h"
  32
  33 /**
  34    Replaces the extension in \p buf of max.<br>
  35    size \p buflen with the extension in \p ext.<br>
  36    If there's no '.' in \p buf, \p ext is appended.<br>
  37    If \p ext is NULL, behaves as if it were an empty string ("").
  38
  39    \b Example
  40    \code
  41    #include <FL/filename.H>
  42    [..]
  43    char buf[FL_PATH_MAX] = "/path/myfile.cxx";
  44    fl_filename_setext(buf, sizeof(buf), ".txt");      // buf[] becomes "/path/myfile.txt"
  45    \endcode
  46
  47    \return buf itself for calling convenience.
  48 */
  49 char *fl_filename_setext(char *buf, int buflen, const char *ext) {
  50   char *q = (char *)fl_filename_ext(buf);
  51   if (ext) {
  52     strlcpy(q,ext,buflen - (q - buf));
  53   } else *q = 0;
  54   return(buf);
  55 }
  56
  57
  58 //
  59 // End of "$Id: filename_setext.cxx 8063 2010-12-19 21:20:10Z matt $".
  60 //