blob: 927ea48721d88ff38b8feb7809f26ac07858bd1e [file] [log] [blame]
DRC2ff39b82011-07-28 08:38:59 +00001//
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*/
49char *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//