src/common/filefn.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        filefn.cpp
   3 // Purpose:     File- and directory-related functions
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     29/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1998 Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21     #pragma implementation "filefn.h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26 #include "wx/defs.h"
  27
  28 #ifdef __BORLANDC__
  29     #pragma hdrstop
  30 #endif
  31
  32 #include "wx/utils.h"
  33 #include "wx/intl.h"
  34 #include "wx/file.h"
  35 #include "wx/filename.h"
  36 #include "wx/dir.h"
  37
  38 // there are just too many of those...
  39 #ifdef __VISUALC__
  40     #pragma warning(disable:4706)   // assignment within conditional expression
  41 #endif // VC++
  42
  43 #include <ctype.h>
  44 #include <stdio.h>
  45 #include <stdlib.h>
  46 #include <string.h>
  47 #if !defined(__WATCOMC__)
  48     #if !(defined(_MSC_VER) && (_MSC_VER > 800))
  49         #include <errno.h>
  50     #endif
  51 #endif
  52
  53 #if defined(__WXMAC__)
  54   #include  "wx/mac/private.h"  // includes mac headers
  55 #endif
  56
  57 #include <time.h>
  58
  59 #ifndef __MWERKS__
  60     #include <sys/types.h>
  61     #include <sys/stat.h>
  62 #else
  63 #ifdef __MACH__
  64 #include <sys/types.h>
  65 #include <utime.h>
  66 #include <sys/stat.h>
  67 #include <unistd.h>
  68 #else
  69     #include <stat.h>
  70     #include <unistd.h>
  71     #include <unix.h>
  72     #include <fcntl.h>
  73 #endif
  74 #endif
  75
  76 #ifdef __UNIX__
  77     #include <unistd.h>
  78     #include <dirent.h>
  79     #include <fcntl.h>
  80 #endif
  81
  82 #ifdef __WXPM__
  83     #include <process.h>
  84     #include "wx/os2/private.h"
  85 #endif
  86 #if defined(__WINDOWS__) && !defined(__WXMICROWIN__)
  87 #if !defined( __GNUWIN32__ ) && !defined( __MWERKS__ ) && !defined(__SALFORDC__)
  88     #include <direct.h>
  89     #include <dos.h>
  90     #include <io.h>
  91 #endif // __WINDOWS__
  92 #endif // native Win compiler
  93
  94 #if defined(__DOS__)
  95     #ifdef __WATCOMC__
  96         #include <direct.h>
  97         #include <dos.h>
  98         #include <io.h>
  99     #endif
 100     #ifdef __DJGPP__
 101         #include <unistd.h>
 102     #endif
 103 #endif
 104
 105 #ifdef __BORLANDC__ // Please someone tell me which version of Borland needs
 106                     // this (3.1 I believe) and how to test for it.
 107                     // If this works for Borland 4.0 as well, then no worries.
 108     #include <dir.h>
 109 #endif
 110
 111 #ifdef __SALFORDC__
 112     #include <dir.h>
 113     #include <unix.h>
 114 #endif
 115
 116 #include "wx/log.h"
 117
 118 // No, Cygwin doesn't appear to have fnmatch.h after all.
 119 #if defined(HAVE_FNMATCH_H)
 120     #include "fnmatch.h"
 121 #endif
 122
 123 #ifdef __WINDOWS__
 124     #include <windows.h>
 125     #include "wx/msw/mslu.h"
 126
 127     // for _getcwd
 128     #ifdef __MINGW32__
 129         #include <io.h>
 130     #endif
 131
 132     // sys/cygwin.h is needed for cygwin_conv_to_full_win32_path()
 133     //
 134     // note that it must be included after <windows.h>
 135     #ifdef __GNUWIN32__
 136         #ifdef __CYGWIN__
 137             #include <sys/cygwin.h>
 138         #endif
 139     #endif // __GNUWIN32__
 140 #endif // __WINDOWS__
 141
 142 // TODO: Borland probably has _wgetcwd as well?
 143 #ifdef _MSC_VER
 144     #define HAVE_WGETCWD
 145 #endif
 146
 147 // ----------------------------------------------------------------------------
 148 // constants
 149 // ----------------------------------------------------------------------------
 150
 151 #ifndef _MAXPATHLEN
 152     #define _MAXPATHLEN 1024
 153 #endif
 154
 155 #ifdef __WXMAC__
 156 #  ifdef __DARWIN__
 157 #    include "MoreFilesX.h"
 158 #  else
 159 #    include "MoreFiles.h"
 160 #    include "MoreFilesExtras.h"
 161 #    include "FullPath.h"
 162 #    include "FSpCompat.h"
 163 #  endif
 164 #endif
 165
 166 // ----------------------------------------------------------------------------
 167 // private globals
 168 // ----------------------------------------------------------------------------
 169
 170 // MT-FIXME: get rid of this horror and all code using it
 171 static wxChar wxFileFunctionsBuffer[4*_MAXPATHLEN];
 172
 173 #if defined(__VISAGECPP__) && __IBMCPP__ >= 400
 174 //
 175 // VisualAge C++ V4.0 cannot have any external linkage const decs
 176 // in headers included by more than one primary source
 177 //
 178 const off_t wxInvalidOffset = (off_t)-1;
 179 #endif
 180
 181 // ----------------------------------------------------------------------------
 182 // macros
 183 // ----------------------------------------------------------------------------
 184
 185 // we need to translate Mac filenames before passing them to OS functions
 186 #define OS_FILENAME(s) (s.fn_str())
 187
 188 // ============================================================================
 189 // implementation
 190 // ============================================================================
 191
 192 #if defined(__WXMAC__) && !defined(__DARWIN__)
 193
 194 WXDLLEXPORT int wxStat( const wxChar *file_name, wxStructStat *buf )
 195 {
 196     return stat( wxMacStringToCString( file_name ), buf );
 197 }
 198
 199 WXDLLEXPORT int wxAccess( const wxChar *pathname, int mode )
 200 {
 201     return access( wxMacStringToCString( pathname ), mode );
 202 }
 203
 204 WXDLLEXPORT int wxOpen( const wxChar *pathname, int flags, mode_t mode )
 205 {
 206     return open( wxMacStringToCString( pathname ), flags, mode );
 207 }
 208
 209 #endif
 210
 211 #ifdef wxNEED_WX_UNISTD_H
 212
 213 WXDLLEXPORT int wxStat( const wxChar *file_name, wxStructStat *buf )
 214 {
 215     return stat( wxConvFile.cWX2MB( file_name ), buf );
 216 }
 217
 218 WXDLLEXPORT int wxAccess( const wxChar *pathname, int mode )
 219 {
 220     return access( wxConvFile.cWX2MB( pathname ), mode );
 221 }
 222
 223 WXDLLEXPORT int wxOpen( const wxChar *pathname, int flags, mode_t mode )
 224 {
 225     return open( wxConvFile.cWX2MB( pathname ), flags, mode );
 226 }
 227
 228 #endif
 229    // wxNEED_WX_UNISTD_H
 230
 231 // ----------------------------------------------------------------------------
 232 // wxPathList
 233 // ----------------------------------------------------------------------------
 234
 235 // IMPLEMENT_DYNAMIC_CLASS(wxPathList, wxStringList)
 236
 237 static inline wxChar* MYcopystring(const wxString& s)
 238 {
 239     wxChar* copy = new wxChar[s.length() + 1];
 240     return wxStrcpy(copy, s.c_str());
 241 }
 242
 243 static inline wxChar* MYcopystring(const wxChar* s)
 244 {
 245     wxChar* copy = new wxChar[wxStrlen(s) + 1];
 246     return wxStrcpy(copy, s);
 247 }
 248
 249 void wxPathList::Add (const wxString& path)
 250 {
 251     wxStringList::Append (WXSTRINGCAST path);
 252 }
 253
 254 // Add paths e.g. from the PATH environment variable
 255 void wxPathList::AddEnvList (const wxString& envVariable)
 256 {
 257     static const wxChar PATH_TOKS[] =
 258 #ifdef __WINDOWS__
 259         /*
 260         The space has been removed from the tokenizers, otherwise a
 261         path such as "C:\Program Files" would be split into 2 paths:
 262         "C:\Program" and "Files"
 263         */
 264 //        wxT(" ;"); // Don't seperate with colon in DOS (used for drive)
 265         wxT(";"); // Don't seperate with colon in DOS (used for drive)
 266 #else
 267         wxT(" :;");
 268 #endif
 269
 270     wxChar *val = wxGetenv (WXSTRINGCAST envVariable);
 271     if (val && *val)
 272     {
 273         wxChar *s = MYcopystring (val);
 274         wxChar *save_ptr, *token = wxStrtok (s, PATH_TOKS, &save_ptr);
 275
 276         if (token)
 277         {
 278             Add(token);
 279             while (token)
 280             {
 281                 if ( (token = wxStrtok ((wxChar *) NULL, PATH_TOKS, &save_ptr))
 282                     != NULL )
 283                 {
 284                     Add(token);
 285                 }
 286             }
 287         }
 288
 289         // suppress warning about unused variable save_ptr when wxStrtok() is a
 290         // macro which throws away its third argument
 291         save_ptr = token;
 292
 293         delete [] s;
 294     }
 295 }
 296
 297 // Given a full filename (with path), ensure that that file can
 298 // be accessed again USING FILENAME ONLY by adding the path
 299 // to the list if not already there.
 300 void wxPathList::EnsureFileAccessible (const wxString& path)
 301 {
 302     wxString path_only(wxPathOnly(path));
 303     if ( !path_only.IsEmpty() )
 304     {
 305         if ( !Member(path_only) )
 306             Add(path_only);
 307     }
 308 }
 309
 310 bool wxPathList::Member (const wxString& path)
 311 {
 312   for (wxStringList::compatibility_iterator node = GetFirst(); node; node = node->GetNext())
 313   {
 314       wxString path2( node->GetData() );
 315       if (
 316 #if defined(__WINDOWS__) || defined(__VMS__) || defined (__WXMAC__)
 317       // Case INDEPENDENT
 318           path.CompareTo (path2, wxString::ignoreCase) == 0
 319 #else
 320       // Case sensitive File System
 321           path.CompareTo (path2) == 0
 322 #endif
 323         )
 324         return TRUE;
 325   }
 326   return FALSE;
 327 }
 328
 329 wxString wxPathList::FindValidPath (const wxString& file)
 330 {
 331   if (wxFileExists (wxExpandPath(wxFileFunctionsBuffer, file)))
 332     return wxString(wxFileFunctionsBuffer);
 333
 334   wxChar buf[_MAXPATHLEN];
 335   wxStrcpy(buf, wxFileFunctionsBuffer);
 336
 337   wxChar *filename = (wxChar*) NULL; /* shut up buggy egcs warning */
 338   filename = wxIsAbsolutePath (buf) ? wxFileNameFromPath (buf) : (wxChar *)buf;
 339
 340   for (wxStringList::compatibility_iterator node = GetFirst(); node; node = node->GetNext())
 341     {
 342       const wxChar *path = node->GetData();
 343       wxStrcpy (wxFileFunctionsBuffer, path);
 344       wxChar ch = wxFileFunctionsBuffer[wxStrlen(wxFileFunctionsBuffer)-1];
 345       if (ch != wxT('\\') && ch != wxT('/'))
 346         wxStrcat (wxFileFunctionsBuffer, wxT("/"));
 347       wxStrcat (wxFileFunctionsBuffer, filename);
 348 #ifdef __WINDOWS__
 349       wxUnix2DosFilename (wxFileFunctionsBuffer);
 350 #endif
 351       if (wxFileExists (wxFileFunctionsBuffer))
 352       {
 353         return wxString(wxFileFunctionsBuffer);        // Found!
 354       }
 355     }                                // for()
 356
 357   return wxEmptyString;                    // Not found
 358 }
 359
 360 wxString wxPathList::FindAbsoluteValidPath (const wxString& file)
 361 {
 362     wxString f = FindValidPath(file);
 363     if ( wxIsAbsolutePath(f) )
 364         return f;
 365
 366     wxString buf;
 367     wxGetWorkingDirectory(wxStringBuffer(buf, _MAXPATHLEN), _MAXPATHLEN);
 368
 369     if ( !wxEndsWithPathSeparator(buf) )
 370     {
 371         buf += wxFILE_SEP_PATH;
 372     }
 373     buf += f;
 374
 375     return buf;
 376 }
 377
 378 bool
 379 wxFileExists (const wxString& filename)
 380 {
 381     // we must use GetFileAttributes() instead of the ANSI C functions because
 382     // it can cope with network (UNC) paths unlike them
 383 #if defined(__WIN32__) && !defined(__WXMICROWIN__)
 384     DWORD ret = ::GetFileAttributes(filename);
 385
 386     return (ret != (DWORD)-1) && !(ret & FILE_ATTRIBUTE_DIRECTORY);
 387 #else // !__WIN32__
 388     wxStructStat st;
 389     return wxStat(filename, &st) == 0 && (st.st_mode & S_IFREG);
 390 #endif // __WIN32__/!__WIN32__
 391 }
 392
 393 bool
 394 wxIsAbsolutePath (const wxString& filename)
 395 {
 396     if (filename != wxT(""))
 397     {
 398 #if defined(__WXMAC__) && !defined(__DARWIN__)
 399         // Classic or Carbon CodeWarrior like
 400         // Carbon with Apple DevTools is Unix like
 401
 402         // This seems wrong to me, but there is no fix. since
 403         // "MacOS:MyText.txt" is absolute whereas "MyDir:MyText.txt"
 404         // is not. Or maybe ":MyDir:MyText.txt" has to be used? RR.
 405         if (filename.Find(':') != wxNOT_FOUND && filename[0] != ':')
 406             return TRUE ;
 407 #else
 408         // Unix like or Windows
 409         if (filename[0] == wxT('/'))
 410             return TRUE;
 411 #endif
 412 #ifdef __VMS__
 413         if ((filename[0] == wxT('[') && filename[1] != wxT('.')))
 414             return TRUE;
 415 #endif
 416 #ifdef __WINDOWS__
 417         // MSDOS like
 418         if (filename[0] == wxT('\\') || (wxIsalpha (filename[0]) && filename[1] == wxT(':')))
 419             return TRUE;
 420 #endif
 421     }
 422     return FALSE ;
 423 }
 424
 425 /*
 426  * Strip off any extension (dot something) from end of file,
 427  * IF one exists. Inserts zero into buffer.
 428  *
 429  */
 430
 431 void wxStripExtension(wxChar *buffer)
 432 {
 433   int len = wxStrlen(buffer);
 434   int i = len-1;
 435   while (i > 0)
 436   {
 437     if (buffer[i] == wxT('.'))
 438     {
 439       buffer[i] = 0;
 440       break;
 441     }
 442     i --;
 443   }
 444 }
 445
 446 void wxStripExtension(wxString& buffer)
 447 {
 448   size_t len = buffer.Length();
 449   size_t i = len-1;
 450   while (i > 0)
 451   {
 452     if (buffer.GetChar(i) == wxT('.'))
 453     {
 454       buffer = buffer.Left(i);
 455       break;
 456     }
 457     i --;
 458   }
 459 }
 460
 461 // Destructive removal of /./ and /../ stuff
 462 wxChar *wxRealPath (wxChar *path)
 463 {
 464 #ifdef __WXMSW__
 465   static const wxChar SEP = wxT('\\');
 466   wxUnix2DosFilename(path);
 467 #else
 468   static const wxChar SEP = wxT('/');
 469 #endif
 470   if (path[0] && path[1]) {
 471     /* MATTHEW: special case "/./x" */
 472     wxChar *p;
 473     if (path[2] == SEP && path[1] == wxT('.'))
 474       p = &path[0];
 475     else
 476       p = &path[2];
 477     for (; *p; p++)
 478       {
 479         if (*p == SEP)
 480           {
 481             if (p[1] == wxT('.') && p[2] == wxT('.') && (p[3] == SEP || p[3] == wxT('\0')))
 482               {
 483                 wxChar *q;
 484                 for (q = p - 1; q >= path && *q != SEP; q--)
 485                 {
 486                     // Empty
 487                 }
 488
 489                 if (q[0] == SEP && (q[1] != wxT('.') || q[2] != wxT('.') || q[3] != SEP)
 490                     && (q - 1 <= path || q[-1] != SEP))
 491                   {
 492                     wxStrcpy (q, p + 3);
 493                     if (path[0] == wxT('\0'))
 494                       {
 495                         path[0] = SEP;
 496                         path[1] = wxT('\0');
 497                       }
 498 #ifdef __WXMSW__
 499                     /* Check that path[2] is NULL! */
 500                     else if (path[1] == wxT(':') && !path[2])
 501                       {
 502                         path[2] = SEP;
 503                         path[3] = wxT('\0');
 504                       }
 505 #endif
 506                     p = q - 1;
 507                   }
 508               }
 509             else if (p[1] == wxT('.') && (p[2] == SEP || p[2] == wxT('\0')))
 510               wxStrcpy (p, p + 2);
 511           }
 512       }
 513   }
 514   return path;
 515 }
 516
 517 // Must be destroyed
 518 wxChar *wxCopyAbsolutePath(const wxString& filename)
 519 {
 520   if (filename == wxT(""))
 521     return (wxChar *) NULL;
 522
 523   if (! wxIsAbsolutePath(wxExpandPath(wxFileFunctionsBuffer, filename))) {
 524     wxChar  buf[_MAXPATHLEN];
 525     buf[0] = wxT('\0');
 526     wxGetWorkingDirectory(buf, WXSIZEOF(buf));
 527     wxChar ch = buf[wxStrlen(buf) - 1];
 528 #ifdef __WXMSW__
 529     if (ch != wxT('\\') && ch != wxT('/'))
 530         wxStrcat(buf, wxT("\\"));
 531 #else
 532     if (ch != wxT('/'))
 533         wxStrcat(buf, wxT("/"));
 534 #endif
 535     wxStrcat(buf, wxFileFunctionsBuffer);
 536     return MYcopystring( wxRealPath(buf) );
 537   }
 538   return MYcopystring( wxFileFunctionsBuffer );
 539 }
 540
 541 /*-
 542  Handles:
 543    ~/ => home dir
 544    ~user/ => user's home dir
 545    If the environment variable a = "foo" and b = "bar" then:
 546    Unix:
 547         $a        =>        foo
 548         $a$b        =>        foobar
 549         $a.c        =>        foo.c
 550         xxx$a        =>        xxxfoo
 551         ${a}!        =>        foo!
 552         $(b)!        =>        bar!
 553         \$a        =>        \$a
 554    MSDOS:
 555         $a        ==>        $a
 556         $(a)        ==>        foo
 557         $(a)$b        ==>        foo$b
 558         $(a)$(b)==>        foobar
 559         test.$$        ==>        test.$$
 560  */
 561
 562 /* input name in name, pathname output to buf. */
 563
 564 wxChar *wxExpandPath(wxChar *buf, const wxChar *name)
 565 {
 566     register wxChar *d, *s, *nm;
 567     wxChar          lnm[_MAXPATHLEN];
 568     int             q;
 569
 570     // Some compilers don't like this line.
 571 //    const wxChar    trimchars[] = wxT("\n \t");
 572
 573     wxChar      trimchars[4];
 574     trimchars[0] = wxT('\n');
 575     trimchars[1] = wxT(' ');
 576     trimchars[2] = wxT('\t');
 577     trimchars[3] = 0;
 578
 579 #ifdef __WXMSW__
 580      const wxChar     SEP = wxT('\\');
 581 #else
 582      const wxChar     SEP = wxT('/');
 583 #endif
 584     buf[0] = wxT('\0');
 585     if (name == NULL || *name == wxT('\0'))
 586         return buf;
 587     nm = MYcopystring(name); // Make a scratch copy
 588     wxChar *nm_tmp = nm;
 589
 590     /* Skip leading whitespace and cr */
 591     while (wxStrchr((wxChar *)trimchars, *nm) != NULL)
 592         nm++;
 593     /* And strip off trailing whitespace and cr */
 594     s = nm + (q = wxStrlen(nm)) - 1;
 595     while (q-- && wxStrchr((wxChar *)trimchars, *s) != NULL)
 596         *s = wxT('\0');
 597
 598     s = nm;
 599     d = lnm;
 600 #ifdef __WXMSW__
 601     q = FALSE;
 602 #else
 603     q = nm[0] == wxT('\\') && nm[1] == wxT('~');
 604 #endif
 605
 606     /* Expand inline environment variables */
 607 #ifdef __VISAGECPP__
 608     while (*d)
 609     {
 610       *d++ = *s;
 611       if(*s == wxT('\\'))
 612       {
 613         *(d - 1) = *++s;
 614         if (*d)
 615         {
 616           s++;
 617           continue;
 618         }
 619         else
 620            break;
 621       }
 622       else
 623 #else
 624     while ((*d++ = *s) != 0) {
 625 #  ifndef __WXMSW__
 626         if (*s == wxT('\\')) {
 627             if ((*(d - 1) = *++s)) {
 628                 s++;
 629                 continue;
 630             } else
 631                 break;
 632         } else
 633 #  endif
 634 #endif
 635 #ifdef __WXMSW__
 636         if (*s++ == wxT('$') && (*s == wxT('{') || *s == wxT(')')))
 637 #else
 638         if (*s++ == wxT('$'))
 639 #endif
 640         {
 641             register wxChar  *start = d;
 642             register int     braces = (*s == wxT('{') || *s == wxT('('));
 643             register wxChar  *value;
 644             while ((*d++ = *s) != 0)
 645                 if (braces ? (*s == wxT('}') || *s == wxT(')')) : !(wxIsalnum(*s) || *s == wxT('_')) )
 646                     break;
 647                 else
 648                     s++;
 649             *--d = 0;
 650             value = wxGetenv(braces ? start + 1 : start);
 651             if (value) {
 652                 for ((d = start - 1); (*d++ = *value++) != 0;)
 653                 {
 654                     // Empty
 655                 }
 656
 657                 d--;
 658                 if (braces && *s)
 659                     s++;
 660             }
 661         }
 662     }
 663
 664     /* Expand ~ and ~user */
 665     nm = lnm;
 666     if (nm[0] == wxT('~') && !q)
 667     {
 668         /* prefix ~ */
 669         if (nm[1] == SEP || nm[1] == 0)
 670         {        /* ~/filename */
 671         // FIXME: wxGetUserHome could return temporary storage in Unicode mode
 672             if ((s = WXSTRINGCAST wxGetUserHome(wxT(""))) != NULL) {
 673                 if (*++nm)
 674                     nm++;
 675             }
 676         } else
 677         {                /* ~user/filename */
 678             register wxChar  *nnm;
 679             register wxChar  *home;
 680             for (s = nm; *s && *s != SEP; s++)
 681             {
 682                 // Empty
 683             }
 684             int was_sep; /* MATTHEW: Was there a separator, or NULL? */
 685             was_sep = (*s == SEP);
 686             nnm = *s ? s + 1 : s;
 687             *s = 0;
 688         // FIXME: wxGetUserHome could return temporary storage in Unicode mode
 689             if ((home = WXSTRINGCAST wxGetUserHome(wxString(nm + 1))) == NULL) {
 690                if (was_sep) /* replace only if it was there: */
 691                    *s = SEP;
 692                 s = NULL;
 693             } else {
 694                 nm = nnm;
 695                 s = home;
 696             }
 697         }
 698     }
 699
 700     d = buf;
 701     if (s && *s) { /* MATTHEW: s could be NULL if user '~' didn't exist */
 702         /* Copy home dir */
 703         while (wxT('\0') != (*d++ = *s++))
 704           /* loop */;
 705         // Handle root home
 706         if (d - 1 > buf && *(d - 2) != SEP)
 707           *(d - 1) = SEP;
 708     }
 709     s = nm;
 710     while ((*d++ = *s++) != 0)
 711     {
 712         // Empty
 713     }
 714     delete[] nm_tmp; // clean up alloc
 715     /* Now clean up the buffer */
 716     return wxRealPath(buf);
 717 }
 718
 719 /* Contract Paths to be build upon an environment variable
 720    component:
 721
 722    example: "/usr/openwin/lib", OPENWINHOME --> ${OPENWINHOME}/lib
 723
 724    The call wxExpandPath can convert these back!
 725  */
 726 wxChar *
 727 wxContractPath (const wxString& filename, const wxString& envname, const wxString& user)
 728 {
 729   static wxChar dest[_MAXPATHLEN];
 730
 731   if (filename == wxT(""))
 732     return (wxChar *) NULL;
 733
 734   wxStrcpy (dest, WXSTRINGCAST filename);
 735 #ifdef __WXMSW__
 736   wxUnix2DosFilename(dest);
 737 #endif
 738
 739   // Handle environment
 740   const wxChar *val = (const wxChar *) NULL;
 741   wxChar *tcp = (wxChar *) NULL;
 742   if (envname != WXSTRINGCAST NULL && (val = wxGetenv (WXSTRINGCAST envname)) != NULL &&
 743      (tcp = wxStrstr (dest, val)) != NULL)
 744     {
 745         wxStrcpy (wxFileFunctionsBuffer, tcp + wxStrlen (val));
 746         *tcp++ = wxT('$');
 747         *tcp++ = wxT('{');
 748         wxStrcpy (tcp, WXSTRINGCAST envname);
 749         wxStrcat (tcp, wxT("}"));
 750         wxStrcat (tcp, wxFileFunctionsBuffer);
 751     }
 752
 753   // Handle User's home (ignore root homes!)
 754   size_t len = 0;
 755   if ((val = wxGetUserHome (user)) != NULL &&
 756       (len = wxStrlen(val)) > 2 &&
 757       wxStrncmp(dest, val, len) == 0)
 758     {
 759       wxStrcpy(wxFileFunctionsBuffer, wxT("~"));
 760       if (user != wxT(""))
 761              wxStrcat(wxFileFunctionsBuffer, (const wxChar*) user);
 762       wxStrcat(wxFileFunctionsBuffer, dest + len);
 763       wxStrcpy (dest, wxFileFunctionsBuffer);
 764     }
 765
 766   return dest;
 767 }
 768
 769 // Return just the filename, not the path (basename)
 770 wxChar *wxFileNameFromPath (wxChar *path)
 771 {
 772     wxString p = path;
 773     wxString n = wxFileNameFromPath(p);
 774
 775     return path + p.length() - n.length();
 776 }
 777
 778 wxString wxFileNameFromPath (const wxString& path)
 779 {
 780     wxString name, ext;
 781     wxFileName::SplitPath(path, NULL, &name, &ext);
 782
 783     wxString fullname = name;
 784     if ( !ext.empty() )
 785     {
 786         fullname << wxFILE_SEP_EXT << ext;
 787     }
 788
 789     return fullname;
 790 }
 791
 792 // Return just the directory, or NULL if no directory
 793 wxChar *
 794 wxPathOnly (wxChar *path)
 795 {
 796     if (path && *path)
 797     {
 798         static wxChar buf[_MAXPATHLEN];
 799
 800         // Local copy
 801         wxStrcpy (buf, path);
 802
 803         int l = wxStrlen(path);
 804         int i = l - 1;
 805
 806         // Search backward for a backward or forward slash
 807         while (i > -1)
 808         {
 809 #if defined(__WXMAC__) && !defined(__DARWIN__)
 810             // Classic or Carbon CodeWarrior like
 811             // Carbon with Apple DevTools is Unix like
 812             if (path[i] == wxT(':') )
 813             {
 814                 buf[i] = 0;
 815                 return buf;
 816             }
 817 #else
 818             // Unix like or Windows
 819             if (path[i] == wxT('/') || path[i] == wxT('\\'))
 820             {
 821                 buf[i] = 0;
 822                 return buf;
 823             }
 824 #endif
 825 #ifdef __VMS__
 826             if (path[i] == wxT(']'))
 827             {
 828                 buf[i+1] = 0;
 829                 return buf;
 830             }
 831 #endif
 832             i --;
 833         }
 834
 835 #if defined(__WXMSW__) || defined(__WXPM__)
 836         // Try Drive specifier
 837         if (wxIsalpha (buf[0]) && buf[1] == wxT(':'))
 838         {
 839             // A:junk --> A:. (since A:.\junk Not A:\junk)
 840             buf[2] = wxT('.');
 841             buf[3] = wxT('\0');
 842             return buf;
 843         }
 844 #endif
 845     }
 846     return (wxChar *) NULL;
 847 }
 848
 849 // Return just the directory, or NULL if no directory
 850 wxString wxPathOnly (const wxString& path)
 851 {
 852     if (path != wxT(""))
 853     {
 854         wxChar buf[_MAXPATHLEN];
 855
 856         // Local copy
 857         wxStrcpy (buf, WXSTRINGCAST path);
 858
 859         int l = path.Length();
 860         int i = l - 1;
 861
 862         // Search backward for a backward or forward slash
 863         while (i > -1)
 864         {
 865 #if defined(__WXMAC__) && !defined(__DARWIN__)
 866             // Classic or Carbon CodeWarrior like
 867             // Carbon with Apple DevTools is Unix like
 868             if (path[i] == wxT(':') )
 869             {
 870                 buf[i] = 0;
 871                 return wxString(buf);
 872             }
 873 #else
 874             // Unix like or Windows
 875             if (path[i] == wxT('/') || path[i] == wxT('\\'))
 876             {
 877                 buf[i] = 0;
 878                 return wxString(buf);
 879             }
 880 #endif
 881 #ifdef __VMS__
 882             if (path[i] == wxT(']'))
 883             {
 884                 buf[i+1] = 0;
 885                 return wxString(buf);
 886             }
 887 #endif
 888             i --;
 889         }
 890
 891 #if defined(__WXMSW__) || defined(__WXPM__)
 892         // Try Drive specifier
 893         if (wxIsalpha (buf[0]) && buf[1] == wxT(':'))
 894         {
 895             // A:junk --> A:. (since A:.\junk Not A:\junk)
 896             buf[2] = wxT('.');
 897             buf[3] = wxT('\0');
 898             return wxString(buf);
 899         }
 900 #endif
 901     }
 902     return wxString(wxT(""));
 903 }
 904
 905 // Utility for converting delimiters in DOS filenames to UNIX style
 906 // and back again - or we get nasty problems with delimiters.
 907 // Also, convert to lower case, since case is significant in UNIX.
 908
 909 #if defined(__WXMAC__)
 910 wxString wxMacFSSpec2MacFilename( const FSSpec *spec )
 911 {
 912 #ifdef __DARWIN__
 913     int         i;
 914     int         j;
 915     OSErr       theErr;
 916     OSStatus    theStatus;
 917     Boolean     isDirectory = FALSE;
 918     Str255    theParentPath = "\p";
 919     FSSpec      theParentSpec;
 920     FSRef       theParentRef;
 921     char        theFileName[FILENAME_MAX];
 922     char        thePath[FILENAME_MAX];
 923
 924     strcpy(thePath, "");
 925
 926     // GD: Separate file name from path and make a FSRef to the parent
 927     //     directory. This is necessary since FSRefs cannot reference files
 928     //     that have not yet been created.
 929     //     Based on example code from Apple Technical Note TN2022
 930     //       http://developer.apple.com/technotes/tn/tn2022.html
 931
 932     // check whether we are converting a directory
 933     isDirectory = ((spec->name)[spec->name[0]] == ':');
 934     // count length of file name
 935     for (i = spec->name[0] - (isDirectory ? 1 : 0); ((spec->name[i] != ':') && (i > 0)); i--);
 936     // copy file name
 937     //   prepend path separator since it will later be appended to the path
 938     theFileName[0] = wxFILE_SEP_PATH;
 939     for (j = i + 1; j <= spec->name[0] - (isDirectory ? 1 : 0); j++) {
 940         theFileName[j - i] = spec->name[j];
 941     }
 942     theFileName[j - i] = '\0';
 943     // copy path if any
 944     for (j = 1; j <= i; j++) {
 945         theParentPath[++theParentPath[0]] = spec->name[j];
 946     }
 947     theErr = FSMakeFSSpec(spec->vRefNum, spec->parID, theParentPath, &theParentSpec);
 948     if (theErr == noErr) {
 949         // convert the FSSpec to an FSRef
 950         theErr = FSpMakeFSRef(&theParentSpec, &theParentRef);
 951     }
 952     if (theErr == noErr) {
 953         // get the POSIX path associated with the FSRef
 954         theStatus = FSRefMakePath(&theParentRef,
 955                                   (UInt8 *)thePath, sizeof(thePath));
 956     }
 957     if (theStatus == noErr) {
 958         // append file name to path
 959         //   includes previously prepended path separator
 960         strcat(thePath, theFileName);
 961     }
 962
 963     // create path string for return value
 964     wxString result( thePath ) ;
 965 #else
 966     Handle    myPath ;
 967     short     length ;
 968
 969     // get length of path and allocate handle
 970     FSpGetFullPath( spec , &length , &myPath ) ;
 971     ::SetHandleSize( myPath , length + 1 ) ;
 972     ::HLock( myPath ) ;
 973     (*myPath)[length] = 0 ;
 974     if ((length > 0) && ((*myPath)[length-1] == ':'))
 975         (*myPath)[length-1] = 0 ;
 976
 977     // create path string for return value
 978     wxString result = wxMacMakeStringFromCString( *myPath ) ;
 979
 980     // free allocated handle
 981     ::HUnlock( myPath ) ;
 982     ::DisposeHandle( myPath ) ;
 983 #endif
 984
 985     return result ;
 986 }
 987 #ifndef __DARWIN__
 988 // Mac file names are POSIX (Unix style) under Darwin
 989 // therefore the conversion functions below are not needed
 990
 991 static wxChar sMacFileNameConversion[ 1000 ] ;
 992 static char scMacFileNameConversion[ 1000 ] ;
 993
 994 #endif
 995 void wxMacFilename2FSSpec( const char *path , FSSpec *spec )
 996 {
 997     OSStatus err = noErr ;
 998 #ifdef __DARWIN__
 999     FSRef theRef;
1000
1001     // get the FSRef associated with the POSIX path
1002     err = FSPathMakeRef((const UInt8 *) path, &theRef, NULL);
1003     // convert the FSRef to an FSSpec
1004     err = FSGetCatalogInfo(&theRef, kFSCatInfoNone, NULL, NULL, spec, NULL);
1005 #else
1006     if ( strchr( path , ':' ) == NULL )
1007     {
1008         // try whether it is a volume / or a mounted volume
1009         strncpy( scMacFileNameConversion , path , 1000 ) ;
1010         scMacFileNameConversion[998] = 0 ;
1011         strcat( scMacFileNameConversion , ":" ) ;
1012         err = FSpLocationFromFullPath( strlen(scMacFileNameConversion) , scMacFileNameConversion , spec ) ;
1013     }
1014     else
1015     {
1016         err = FSpLocationFromFullPath( strlen(path) , path , spec ) ;
1017     }
1018 #endif
1019 }
1020
1021 #if wxUSE_UNICODE
1022 WXDLLEXPORT void wxMacFilename2FSSpec( const wxChar *path , FSSpec *spec )
1023 {
1024     return wxMacFilename2FSSpec( wxMacStringToCString( wxString( path ) ) , spec ) ;
1025 }
1026 #endif
1027
1028 #ifndef __DARWIN__
1029
1030 wxString wxMac2UnixFilename (const wxChar *str)
1031 {
1032     wxChar *s = sMacFileNameConversion ;
1033     wxStrcpy( s , str ) ;
1034     if (s)
1035     {
1036         memmove( s+1 , s ,wxStrlen( s ) + 1 * sizeof(wxChar)) ;
1037         if ( *s == ':' )
1038             *s = '.' ;
1039         else
1040             *s = '/' ;
1041
1042         while (*s)
1043         {
1044             if (*s == ':')
1045                 *s = '/';
1046             else
1047                 *s = wxTolower(*s);        // Case INDEPENDENT
1048             s++;
1049         }
1050     }
1051     return wxString(sMacFileNameConversion) ;
1052 }
1053
1054 wxString wxUnix2MacFilename (const wxChar *str)
1055 {
1056     wxChar *s = sMacFileNameConversion ;
1057     wxStrcpy( s , str ) ;
1058     if (s)
1059     {
1060         if ( *s == '.' )
1061         {
1062             // relative path , since it goes on with slash which is translated to a :
1063             memmove( s , s+1 ,wxStrlen( s ) * sizeof(wxChar)) ;
1064         }
1065         else if ( *s == '/' )
1066         {
1067             // absolute path -> on mac just start with the drive name
1068             memmove( s , s+1 ,wxStrlen( s ) * sizeof(wxChar) ) ;
1069         }
1070         else
1071         {
1072             wxASSERT_MSG( 1 , wxT("unkown path beginning") ) ;
1073         }
1074         while (*s)
1075         {
1076             if (*s == '/' || *s == '\\')
1077             {
1078                 // convert any back-directory situations
1079                 if ( *(s+1) == '.' && *(s+2) == '.' && ( (*(s+3) == '/' || *(s+3) == '\\') ) )
1080                 {
1081                     *s = ':';
1082                     memmove( s+1 , s+3 ,(wxStrlen( s+3 ) + 1)*sizeof(wxChar) ) ;
1083                 }
1084                 else
1085                     *s = ':';
1086             }
1087             s++ ;
1088         }
1089     }
1090     return wxString(sMacFileNameConversion) ;
1091 }
1092
1093 wxString wxMacFSSpec2UnixFilename( const FSSpec *spec )
1094 {
1095     return wxMac2UnixFilename( wxMacFSSpec2MacFilename( spec) ) ;
1096 }
1097
1098 void wxUnixFilename2FSSpec( const char *path , FSSpec *spec )
1099 {
1100     wxString var = wxUnix2MacFilename( path ) ;
1101     wxMacFilename2FSSpec( var , spec ) ;
1102 }
1103 #endif // ! __DARWIN__
1104
1105 #endif // __WXMAC__
1106
1107 void
1108 wxDos2UnixFilename (wxChar *s)
1109 {
1110   if (s)
1111     while (*s)
1112       {
1113         if (*s == _T('\\'))
1114           *s = _T('/');
1115 #ifdef __WXMSW__
1116         else
1117           *s = wxTolower (*s);        // Case INDEPENDENT
1118 #endif
1119         s++;
1120       }
1121 }
1122
1123 void
1124 #if defined(__WXMSW__) || defined(__WXPM__)
1125 wxUnix2DosFilename (wxChar *s)
1126 #else
1127 wxUnix2DosFilename (wxChar *WXUNUSED(s) )
1128 #endif
1129 {
1130 // Yes, I really mean this to happen under DOS only! JACS
1131 #if defined(__WXMSW__) || defined(__WXPM__)
1132   if (s)
1133     while (*s)
1134       {
1135         if (*s == wxT('/'))
1136           *s = wxT('\\');
1137         s++;
1138       }
1139 #endif
1140 }
1141
1142 // Concatenate two files to form third
1143 bool
1144 wxConcatFiles (const wxString& file1, const wxString& file2, const wxString& file3)
1145 {
1146   wxString outfile;
1147   if ( !wxGetTempFileName( wxT("cat"), outfile) )
1148       return FALSE;
1149
1150   FILE *fp1 = (FILE *) NULL;
1151   FILE *fp2 = (FILE *) NULL;
1152   FILE *fp3 = (FILE *) NULL;
1153   // Open the inputs and outputs
1154   if ((fp1 = wxFopen ( file1, wxT("rb"))) == NULL ||
1155       (fp2 = wxFopen ( file2, wxT("rb"))) == NULL ||
1156       (fp3 = wxFopen ( outfile, wxT("wb"))) == NULL)
1157     {
1158       if (fp1)
1159         fclose (fp1);
1160       if (fp2)
1161         fclose (fp2);
1162       if (fp3)
1163         fclose (fp3);
1164       return FALSE;
1165     }
1166
1167   int ch;
1168   while ((ch = getc (fp1)) != EOF)
1169     (void) putc (ch, fp3);
1170   fclose (fp1);
1171
1172   while ((ch = getc (fp2)) != EOF)
1173     (void) putc (ch, fp3);
1174   fclose (fp2);
1175
1176   fclose (fp3);
1177   bool result = wxRenameFile(outfile, file3);
1178   return result;
1179 }
1180
1181 // Copy files
1182 bool
1183 wxCopyFile (const wxString& file1, const wxString& file2, bool overwrite)
1184 {
1185 #if defined(__WIN32__) && !defined(__WXMICROWIN__)
1186     // CopyFile() copies file attributes and modification time too, so use it
1187     // instead of our code if available
1188     //
1189     // NB: 3rd parameter is bFailIfExists i.e. the inverse of overwrite
1190     if ( !::CopyFile(file1, file2, !overwrite) )
1191     {
1192         wxLogSysError(_("Failed to copy the file '%s' to '%s'"),
1193                       file1.c_str(), file2.c_str());
1194
1195         return FALSE;
1196     }
1197 #elif defined(__WXPM__)
1198     if ( ::DosCopy(file2, file2, overwrite ? DCPY_EXISTING : 0) != 0 )
1199         return FALSE;
1200 #else // !Win32
1201
1202     wxStructStat fbuf;
1203     // get permissions of file1
1204     if ( wxStat( file1.c_str(), &fbuf) != 0 )
1205     {
1206         // the file probably doesn't exist or we haven't the rights to read
1207         // from it anyhow
1208         wxLogSysError(_("Impossible to get permissions for file '%s'"),
1209                       file1.c_str());
1210         return FALSE;
1211     }
1212
1213     // open file1 for reading
1214     wxFile fileIn(file1, wxFile::read);
1215     if ( !fileIn.IsOpened() )
1216         return FALSE;
1217
1218     // remove file2, if it exists. This is needed for creating
1219     // file2 with the correct permissions in the next step
1220     if ( wxFileExists(file2)  && (!overwrite || !wxRemoveFile(file2)))
1221     {
1222         wxLogSysError(_("Impossible to overwrite the file '%s'"),
1223                       file2.c_str());
1224         return FALSE;
1225     }
1226
1227 #ifdef __UNIX__
1228     // reset the umask as we want to create the file with exactly the same
1229     // permissions as the original one
1230     mode_t oldUmask = umask( 0 );
1231 #endif // __UNIX__
1232
1233     // create file2 with the same permissions than file1 and open it for
1234     // writing
1235
1236     wxFile fileOut;
1237     if ( !fileOut.Create(file2, overwrite, fbuf.st_mode & 0777) )
1238         return FALSE;
1239
1240 #ifdef __UNIX__
1241     /// restore the old umask
1242     umask(oldUmask);
1243 #endif // __UNIX__
1244
1245     // copy contents of file1 to file2
1246     char buf[4096];
1247     size_t count;
1248     for ( ;; )
1249     {
1250         count = fileIn.Read(buf, WXSIZEOF(buf));
1251         if ( fileIn.Error() )
1252             return FALSE;
1253
1254         // end of file?
1255         if ( !count )
1256             break;
1257
1258         if ( fileOut.Write(buf, count) < count )
1259             return FALSE;
1260     }
1261
1262     // we can expect fileIn to be closed successfully, but we should ensure
1263     // that fileOut was closed as some write errors (disk full) might not be
1264     // detected before doing this
1265     if ( !fileIn.Close() || !fileOut.Close() )
1266         return FALSE;
1267
1268 #if !defined(__VISAGECPP__) && !defined(__WXMAC__) || defined(__UNIX__)
1269     // no chmod in VA.  Should be some permission API for HPFS386 partitions
1270     // however
1271     if ( chmod(OS_FILENAME(file2), fbuf.st_mode) != 0 )
1272     {
1273         wxLogSysError(_("Impossible to set permissions for the file '%s'"),
1274                       file2.c_str());
1275         return FALSE;
1276     }
1277 #endif // OS/2 || Mac
1278 #endif // __WXMSW__ && __WIN32__
1279
1280     return TRUE;
1281 }
1282
1283 bool
1284 wxRenameFile (const wxString& file1, const wxString& file2)
1285 {
1286   // Normal system call
1287   if ( wxRename (file1, file2) == 0 )
1288     return TRUE;
1289
1290   // Try to copy
1291   if (wxCopyFile(file1, file2)) {
1292     wxRemoveFile(file1);
1293     return TRUE;
1294   }
1295   // Give up
1296   return FALSE;
1297 }
1298
1299 bool wxRemoveFile(const wxString& file)
1300 {
1301 #if defined(__VISUALC__) \
1302  || defined(__BORLANDC__) \
1303  || defined(__WATCOMC__) \
1304  || defined(__GNUWIN32__)
1305   int res = wxRemove(file);
1306 #elif defined(__WXMAC__)
1307   int res = unlink(wxFNCONV(file));
1308 #else
1309   int res = unlink(OS_FILENAME(file));
1310 #endif
1311
1312   return res == 0;
1313 }
1314
1315 bool wxMkdir(const wxString& dir, int perm)
1316 {
1317 #if defined(__WXMAC__) && !defined(__UNIX__)
1318   return (mkdir( wxFNCONV(dir) , 0 ) == 0);
1319 #else // !Mac
1320     const wxChar *dirname = dir.c_str();
1321
1322     // assume mkdir() has 2 args on non Windows-OS/2 platforms and on Windows too
1323     // for the GNU compiler
1324 #if (!(defined(__WXMSW__) || defined(__WXPM__) || defined(__DOS__))) || (defined(__GNUWIN32__) && !defined(__MINGW32__)) || defined(__WINE__) || defined(__WXMICROWIN__)
1325   #ifndef MSVCRT
1326     if ( mkdir(wxFNCONV(dirname), perm) != 0 )
1327   #else
1328     if ( mkdir(wxFNCONV(dirname)) != 0 )
1329   #endif
1330 #elif defined(__WXPM__)
1331     if (::DosCreateDir((PSZ)dirname, NULL) != 0) // enhance for EAB's??
1332 #elif defined(__DOS__)
1333   #if defined(__WATCOMC__)
1334     (void)perm;
1335     if ( wxMkDir(wxFNSTRINGCAST wxFNCONV(dirname)) != 0 )
1336   #elif defined(__DJGPP__)
1337     if ( mkdir(wxFNCONV(dirname), perm) != 0 )
1338   #else
1339     #error "Unsupported DOS compiler!"
1340   #endif
1341 #else  // !MSW, !DOS and !OS/2 VAC++
1342     (void)perm;
1343     if ( wxMkDir(wxFNSTRINGCAST wxFNCONV(dirname)) != 0 )
1344 #endif // !MSW/MSW
1345     {
1346         wxLogSysError(_("Directory '%s' couldn't be created"), dirname);
1347
1348         return FALSE;
1349     }
1350
1351     return TRUE;
1352 #endif // Mac/!Mac
1353 }
1354
1355 bool wxRmdir(const wxString& dir, int WXUNUSED(flags))
1356 {
1357 #ifdef __VMS__
1358   return FALSE; //to be changed since rmdir exists in VMS7.x
1359 #elif defined(__WXPM__)
1360   return (::DosDeleteDir((PSZ)dir.c_str()) == 0);
1361 #else
1362
1363 #ifdef __SALFORDC__
1364   return FALSE; // What to do?
1365 #else
1366   return (wxRmDir(OS_FILENAME(dir)) == 0);
1367 #endif
1368
1369 #endif
1370 }
1371
1372 // does the path exists? (may have or not '/' or '\\' at the end)
1373 bool wxPathExists(const wxChar *pszPathName)
1374 {
1375     wxString strPath(pszPathName);
1376
1377 #ifdef __WINDOWS__
1378     // Windows fails to find directory named "c:\dir\" even if "c:\dir" exists,
1379     // so remove all trailing backslashes from the path - but don't do this for
1380     // the pathes "d:\" (which are different from "d:") nor for just "\"
1381     while ( wxEndsWithPathSeparator(strPath) )
1382     {
1383         size_t len = strPath.length();
1384         if ( len == 1 || (len == 3 && strPath[len - 2] == _T(':')) )
1385             break;
1386
1387         strPath.Truncate(len - 1);
1388     }
1389 #endif // __WINDOWS__
1390
1391 #if defined(__WIN32__) && !defined(__WXMICROWIN__)
1392     // stat() can't cope with network paths
1393     DWORD ret = ::GetFileAttributes(strPath);
1394
1395     return (ret != (DWORD)-1) && (ret & FILE_ATTRIBUTE_DIRECTORY);
1396 #else // !__WIN32__
1397
1398     wxStructStat st;
1399 #ifndef __VISAGECPP__
1400     return wxStat(pszPathName, &st) == 0 && ((st.st_mode & S_IFMT) == S_IFDIR);
1401 #else
1402     // S_IFMT not supported in VA compilers.. st_mode is a 2byte value only
1403     return wxStat(pszPathName, &st) == 0 && (st.st_mode == S_IFDIR);
1404 #endif
1405
1406 #endif // __WIN32__/!__WIN32__
1407 }
1408
1409 // Get a temporary filename, opening and closing the file.
1410 wxChar *wxGetTempFileName(const wxString& prefix, wxChar *buf)
1411 {
1412     wxString filename = wxFileName::CreateTempFileName(prefix);
1413     if ( filename.empty() )
1414         return NULL;
1415
1416     if ( buf )
1417         wxStrcpy(buf, filename);
1418     else
1419         buf = MYcopystring(filename);
1420
1421     return buf;
1422 }
1423
1424 bool wxGetTempFileName(const wxString& prefix, wxString& buf)
1425 {
1426     buf = wxFileName::CreateTempFileName(prefix);
1427
1428     return !buf.empty();
1429 }
1430
1431 // Get first file name matching given wild card.
1432
1433 static wxDir *gs_dir = NULL;
1434 static wxString gs_dirPath;
1435
1436 wxString wxFindFirstFile(const wxChar *spec, int flags)
1437 {
1438     wxSplitPath(spec, &gs_dirPath, NULL, NULL);
1439     if ( gs_dirPath.IsEmpty() )
1440         gs_dirPath = wxT(".");
1441     if ( !wxEndsWithPathSeparator(gs_dirPath ) )
1442         gs_dirPath << wxFILE_SEP_PATH;
1443
1444     if (gs_dir)
1445         delete gs_dir;
1446     gs_dir = new wxDir(gs_dirPath);
1447
1448     if ( !gs_dir->IsOpened() )
1449     {
1450         wxLogSysError(_("Can not enumerate files '%s'"), spec);
1451         return wxEmptyString;
1452     }
1453
1454     int dirFlags = 0;
1455     switch (flags)
1456     {
1457         case wxDIR:  dirFlags = wxDIR_DIRS; break;
1458         case wxFILE: dirFlags = wxDIR_FILES; break;
1459         default:     dirFlags = wxDIR_DIRS | wxDIR_FILES; break;
1460     }
1461
1462     wxString result;
1463     gs_dir->GetFirst(&result, wxFileNameFromPath(wxString(spec)), dirFlags);
1464     if ( result.IsEmpty() )
1465     {
1466         wxDELETE(gs_dir);
1467         return result;
1468     }
1469
1470     return gs_dirPath + result;
1471 }
1472
1473 wxString wxFindNextFile()
1474 {
1475     wxASSERT_MSG( gs_dir, wxT("You must call wxFindFirstFile before!") );
1476
1477     wxString result;
1478     gs_dir->GetNext(&result);
1479
1480     if ( result.IsEmpty() )
1481     {
1482         wxDELETE(gs_dir);
1483         return result;
1484     }
1485
1486     return gs_dirPath + result;
1487 }
1488
1489
1490 // Get current working directory.
1491 // If buf is NULL, allocates space using new, else
1492 // copies into buf.
1493 wxChar *wxGetWorkingDirectory(wxChar *buf, int sz)
1494 {
1495     if ( !buf )
1496     {
1497         buf = new wxChar[sz + 1];
1498     }
1499
1500     bool ok = FALSE;
1501
1502     // for the compilers which have Unicode version of _getcwd(), call it
1503     // directly, for the others call the ANSI version and do the translation
1504 #if !wxUSE_UNICODE
1505     #define cbuf buf
1506 #else // wxUSE_UNICODE
1507     bool needsANSI = TRUE;
1508
1509     #if !defined(HAVE_WGETCWD) || wxUSE_UNICODE_MSLU
1510         // This is not legal code as the compiler
1511         // is allowed destroy the wxCharBuffer.
1512         // wxCharBuffer c_buffer(sz);
1513         // char *cbuf = (char*)(const char*)c_buffer;
1514         char cbuf[_MAXPATHLEN];
1515     #endif
1516
1517     #ifdef HAVE_WGETCWD
1518         #if wxUSE_UNICODE_MSLU
1519             if ( wxGetOsVersion() != wxWIN95 )
1520         #else
1521             char *cbuf = NULL; // never really used because needsANSI will always be FALSE
1522         #endif
1523             {
1524                 ok = _wgetcwd(buf, sz) != NULL;
1525                 needsANSI = FALSE;
1526             }
1527     #endif
1528
1529     if ( needsANSI )
1530 #endif // wxUSE_UNICODE
1531     {
1532     #if defined(_MSC_VER) || defined(__MINGW32__)
1533         ok = _getcwd(cbuf, sz) != NULL;
1534     #elif defined(__WXMAC__) && !defined(__DARWIN__)
1535         FSSpec cwdSpec ;
1536         FCBPBRec pb;
1537         OSErr error;
1538         Str255  fileName ;
1539         pb.ioNamePtr = (StringPtr) &fileName;
1540         pb.ioVRefNum = 0;
1541         pb.ioRefNum = LMGetCurApRefNum();
1542         pb.ioFCBIndx = 0;
1543         error = PBGetFCBInfoSync(&pb);
1544         if ( error == noErr )
1545         {
1546             cwdSpec.vRefNum = pb.ioFCBVRefNum;
1547             cwdSpec.parID = pb.ioFCBParID;
1548             cwdSpec.name[0] = 0 ;
1549             wxString res = wxMacFSSpec2MacFilename( &cwdSpec ) ;
1550                         wxStrcpy( buf , res ) ;
1551             ok = TRUE;
1552         }
1553         else
1554         {
1555             ok = FALSE;
1556         }
1557     #elif defined(__VISAGECPP__) || (defined (__OS2__) && defined (__WATCOMC__))
1558         APIRET rc;
1559         rc = ::DosQueryCurrentDir( 0 // current drive
1560                                   ,cbuf
1561                                   ,(PULONG)&sz
1562                                  );
1563         ok = rc != 0;
1564     #else // !Win32/VC++ !Mac !OS2
1565         ok = getcwd(cbuf, sz) != NULL;
1566     #endif // platform
1567
1568     #if wxUSE_UNICODE && !defined(__WXMAC__)
1569         // finally convert the result to Unicode if needed
1570         wxConvFile.MB2WC(buf, cbuf, sz);
1571     #endif // wxUSE_UNICODE
1572     }
1573
1574     if ( !ok )
1575     {
1576         wxLogSysError(_("Failed to get the working directory"));
1577
1578         // VZ: the old code used to return "." on error which didn't make any
1579         //     sense at all to me - empty string is a better error indicator
1580         //     (NULL might be even better but I'm afraid this could lead to
1581         //     problems with the old code assuming the return is never NULL)
1582         buf[0] = _T('\0');
1583     }
1584     else // ok, but we might need to massage the path into the right format
1585     {
1586 #ifdef __DJGPP__
1587         // VS: DJGPP is a strange mix of DOS and UNIX API and returns paths
1588         //     with / deliminers. We don't like that.
1589         for (wxChar *ch = buf; *ch; ch++)
1590         {
1591             if (*ch == wxT('/'))
1592                 *ch = wxT('\\');
1593         }
1594 #endif // __DJGPP__
1595
1596 // MBN: we hope that in the case the user is compiling a GTK+/Motif app,
1597 //      he needs Unix as opposed to Win32 pathnames
1598 #if defined( __CYGWIN__ ) && defined( __WINDOWS__ )
1599         // another example of DOS/Unix mix (Cygwin)
1600         wxString pathUnix = buf;
1601         cygwin_conv_to_full_win32_path(pathUnix, buf);
1602 #endif // __CYGWIN__
1603     }
1604
1605     return buf;
1606
1607 #if !wxUSE_UNICODE
1608     #undef cbuf
1609 #endif
1610 }
1611
1612 wxString wxGetCwd()
1613 {
1614     wxChar *buffer = new wxChar[_MAXPATHLEN];
1615     wxGetWorkingDirectory(buffer, _MAXPATHLEN);
1616     wxString str( buffer );
1617     delete [] buffer;
1618
1619     return str;
1620 }
1621
1622 bool wxSetWorkingDirectory(const wxString& d)
1623 {
1624 #if defined(__UNIX__) || defined(__WXMAC__) || defined(__DOS__)
1625   return (chdir(wxFNSTRINGCAST d.fn_str()) == 0);
1626 #elif defined(__WXPM__)
1627   return (::DosSetCurrentDir((PSZ)d.c_str()) == 0);
1628 #elif defined(__WINDOWS__)
1629
1630 #ifdef __WIN32__
1631   return (bool)(SetCurrentDirectory(d) != 0);
1632 #else
1633   // Must change drive, too.
1634   bool isDriveSpec = ((strlen(d) > 1) && (d[1] == ':'));
1635   if (isDriveSpec)
1636   {
1637     wxChar firstChar = d[0];
1638
1639     // To upper case
1640     if (firstChar > 90)
1641       firstChar = firstChar - 32;
1642
1643     // To a drive number
1644     unsigned int driveNo = firstChar - 64;
1645     if (driveNo > 0)
1646     {
1647        unsigned int noDrives;
1648        _dos_setdrive(driveNo, &noDrives);
1649     }
1650   }
1651   bool success = (chdir(WXSTRINGCAST d) == 0);
1652
1653   return success;
1654 #endif
1655
1656 #endif
1657 }
1658
1659 // Get the OS directory if appropriate (such as the Windows directory).
1660 // On non-Windows platform, probably just return the empty string.
1661 wxString wxGetOSDirectory()
1662 {
1663 #if defined(__WINDOWS__) && !defined(__WXMICROWIN__)
1664     wxChar buf[256];
1665     GetWindowsDirectory(buf, 256);
1666     return wxString(buf);
1667 #elif defined(__WXMAC__)
1668     return wxMacFindFolder(kOnSystemDisk, 'macs', false);
1669 #else
1670     return wxEmptyString;
1671 #endif
1672 }
1673
1674 bool wxEndsWithPathSeparator(const wxChar *pszFileName)
1675 {
1676     size_t len = wxStrlen(pszFileName);
1677
1678     return len && wxIsPathSeparator(pszFileName[len - 1]);
1679 }
1680
1681 // find a file in a list of directories, returns FALSE if not found
1682 bool wxFindFileInPath(wxString *pStr, const wxChar *pszPath, const wxChar *pszFile)
1683 {
1684     // we assume that it's not empty
1685     wxCHECK_MSG( !wxIsEmpty(pszFile), FALSE,
1686                  _T("empty file name in wxFindFileInPath"));
1687
1688     // skip path separator in the beginning of the file name if present
1689     if ( wxIsPathSeparator(*pszFile) )
1690         pszFile++;
1691
1692     // copy the path (strtok will modify it)
1693     wxChar *szPath = new wxChar[wxStrlen(pszPath) + 1];
1694     wxStrcpy(szPath, pszPath);
1695
1696     wxString strFile;
1697     wxChar *pc, *save_ptr;
1698     for ( pc = wxStrtok(szPath, wxPATH_SEP, &save_ptr);
1699           pc != NULL;
1700           pc = wxStrtok((wxChar *) NULL, wxPATH_SEP, &save_ptr) )
1701     {
1702         // search for the file in this directory
1703         strFile = pc;
1704         if ( !wxEndsWithPathSeparator(pc) )
1705             strFile += wxFILE_SEP_PATH;
1706         strFile += pszFile;
1707
1708         if ( wxFileExists(strFile) ) {
1709             *pStr = strFile;
1710             break;
1711         }
1712     }
1713
1714     // suppress warning about unused variable save_ptr when wxStrtok() is a
1715     // macro which throws away its third argument
1716     save_ptr = pc;
1717
1718     delete [] szPath;
1719
1720     return pc != NULL;  // if TRUE => we breaked from the loop
1721 }
1722
1723 void WXDLLEXPORT wxSplitPath(const wxChar *pszFileName,
1724                              wxString *pstrPath,
1725                              wxString *pstrName,
1726                              wxString *pstrExt)
1727 {
1728     // it can be empty, but it shouldn't be NULL
1729     wxCHECK_RET( pszFileName, wxT("NULL file name in wxSplitPath") );
1730
1731     wxFileName::SplitPath(pszFileName, pstrPath, pstrName, pstrExt);
1732 }
1733
1734 time_t WXDLLEXPORT wxFileModificationTime(const wxString& filename)
1735 {
1736     wxStructStat buf;
1737     wxStat( filename, &buf);
1738
1739     return buf.st_mtime;
1740 }
1741
1742
1743 //------------------------------------------------------------------------
1744 // wild character routines
1745 //------------------------------------------------------------------------
1746
1747 bool wxIsWild( const wxString& pattern )
1748 {
1749     wxString tmp = pattern;
1750     wxChar *pat = WXSTRINGCAST(tmp);
1751     while (*pat)
1752     {
1753         switch (*pat++)
1754         {
1755         case wxT('?'): case wxT('*'): case wxT('['): case wxT('{'):
1756             return TRUE;
1757         case wxT('\\'):
1758             if (!*pat++)
1759                 return FALSE;
1760         }
1761     }
1762     return FALSE;
1763 }
1764
1765 /*
1766 * Written By Douglas A. Lewis <dalewis@cs.Buffalo.EDU>
1767 *
1768 * The match procedure is public domain code (from ircII's reg.c)
1769 */
1770
1771 bool wxMatchWild( const wxString& pat, const wxString& text, bool dot_special )
1772 {
1773         if (text.empty())
1774         {
1775                 /* Match if both are empty. */
1776                 return pat.empty();
1777         }
1778
1779         const wxChar *m = pat.c_str(),
1780         *n = text.c_str(),
1781         *ma = NULL,
1782         *na = NULL,
1783         *mp = NULL,
1784         *np = NULL;
1785         int just = 0,
1786         pcount = 0,
1787         acount = 0,
1788         count = 0;
1789
1790         if (dot_special && (*n == wxT('.')))
1791         {
1792                 /* Never match so that hidden Unix files
1793                  * are never found. */
1794                 return FALSE;
1795         }
1796
1797         for (;;)
1798         {
1799                 if (*m == wxT('*'))
1800                 {
1801                         ma = ++m;
1802                         na = n;
1803                         just = 1;
1804                         mp = NULL;
1805                         acount = count;
1806                 }
1807                 else if (*m == wxT('?'))
1808                 {
1809                         m++;
1810                         if (!*n++)
1811                         return FALSE;
1812                 }
1813                 else
1814                 {
1815                         if (*m == wxT('\\'))
1816                         {
1817                                 m++;
1818                                 /* Quoting "nothing" is a bad thing */
1819                                 if (!*m)
1820                                 return FALSE;
1821                         }
1822                         if (!*m)
1823                         {
1824                                 /*
1825                                 * If we are out of both strings or we just
1826                                 * saw a wildcard, then we can say we have a
1827                                 * match
1828                                 */
1829                                 if (!*n)
1830                                 return TRUE;
1831                                 if (just)
1832                                 return TRUE;
1833                                 just = 0;
1834                                 goto not_matched;
1835                         }
1836                         /*
1837                         * We could check for *n == NULL at this point, but
1838                         * since it's more common to have a character there,
1839                         * check to see if they match first (m and n) and
1840                         * then if they don't match, THEN we can check for
1841                         * the NULL of n
1842                         */
1843                         just = 0;
1844                         if (*m == *n)
1845                         {
1846                                 m++;
1847                                 if (*n == wxT(' '))
1848                                 mp = NULL;
1849                                 count++;
1850                                 n++;
1851                         }
1852                         else
1853                         {
1854
1855                                 not_matched:
1856
1857                                 /*
1858                                 * If there are no more characters in the
1859                                 * string, but we still need to find another
1860                                 * character (*m != NULL), then it will be
1861                                 * impossible to match it
1862                                 */
1863                                 if (!*n)
1864                                 return FALSE;
1865                                 if (mp)
1866                                 {
1867                                         m = mp;
1868                                         if (*np == wxT(' '))
1869                                         {
1870                                                 mp = NULL;
1871                                                 goto check_percent;
1872                                         }
1873                                         n = ++np;
1874                                         count = pcount;
1875                                 }
1876                                 else
1877                                 check_percent:
1878
1879                                 if (ma)
1880                                 {
1881                                         m = ma;
1882                                         n = ++na;
1883                                         count = acount;
1884                                 }
1885                                 else
1886                                 return FALSE;
1887                         }
1888                 }
1889         }
1890 }
1891
1892
1893 #ifdef __VISUALC__
1894     #pragma warning(default:4706)   // assignment within conditional expression
1895 #endif // VC++