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