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.empty() && (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 #elif defined(__OS2__)
1230     return (::DosSetCurrentDir(WXSTRINGCAST strPath));
1231 #else // !__WIN32__
1232
1233     wxStructStat st;
1234 #ifndef __VISAGECPP__
1235     return wxStat(strPath.c_str(), &st) == 0 && ((st.st_mode & S_IFMT) == S_IFDIR);
1236 #else
1237     // S_IFMT not supported in VA compilers.. st_mode is a 2byte value only
1238     return wxStat(pszPathName, &st) == 0 && (st.st_mode == S_IFDIR);
1239 #endif
1240
1241 #endif // __WIN32__/!__WIN32__
1242 }
1243
1244 // Get a temporary filename, opening and closing the file.
1245 wxChar *wxGetTempFileName(const wxString& prefix, wxChar *buf)
1246 {
1247 #if wxUSE_FILE
1248     wxString filename = wxFileName::CreateTempFileName(prefix);
1249     if ( filename.empty() )
1250         return NULL;
1251
1252     if ( buf )
1253         wxStrcpy(buf, filename);
1254     else
1255         buf = MYcopystring(filename);
1256
1257     return buf;
1258 #else
1259     // wxFileName::CreateTempFileName needs wxFile class enabled
1260     return NULL;
1261 #endif
1262 }
1263
1264 bool wxGetTempFileName(const wxString& prefix, wxString& buf)
1265 {
1266     buf = wxGetTempFileName(prefix);
1267
1268     return !buf.empty();
1269 }
1270
1271 // Get first file name matching given wild card.
1272
1273 static wxDir *gs_dir = NULL;
1274 static wxString gs_dirPath;
1275
1276 wxString wxFindFirstFile(const wxChar *spec, int flags)
1277 {
1278     wxSplitPath(spec, &gs_dirPath, NULL, NULL);
1279     if ( gs_dirPath.empty() )
1280         gs_dirPath = wxT(".");
1281     if ( !wxEndsWithPathSeparator(gs_dirPath ) )
1282         gs_dirPath << wxFILE_SEP_PATH;
1283
1284     if (gs_dir)
1285         delete gs_dir;
1286     gs_dir = new wxDir(gs_dirPath);
1287
1288     if ( !gs_dir->IsOpened() )
1289     {
1290         wxLogSysError(_("Can not enumerate files '%s'"), spec);
1291         return wxEmptyString;
1292     }
1293
1294     int dirFlags;
1295     switch (flags)
1296     {
1297         case wxDIR:  dirFlags = wxDIR_DIRS; break;
1298         case wxFILE: dirFlags = wxDIR_FILES; break;
1299         default:     dirFlags = wxDIR_DIRS | wxDIR_FILES; break;
1300     }
1301
1302     wxString result;
1303     gs_dir->GetFirst(&result, wxFileNameFromPath(wxString(spec)), dirFlags);
1304     if ( result.empty() )
1305     {
1306         wxDELETE(gs_dir);
1307         return result;
1308     }
1309
1310     return gs_dirPath + result;
1311 }
1312
1313 wxString wxFindNextFile()
1314 {
1315     wxASSERT_MSG( gs_dir, wxT("You must call wxFindFirstFile before!") );
1316
1317     wxString result;
1318     gs_dir->GetNext(&result);
1319
1320     if ( result.empty() )
1321     {
1322         wxDELETE(gs_dir);
1323         return result;
1324     }
1325
1326     return gs_dirPath + result;
1327 }
1328
1329
1330 // Get current working directory.
1331 // If buf is NULL, allocates space using new, else
1332 // copies into buf.
1333 wxChar *wxGetWorkingDirectory(wxChar *buf, int sz)
1334 {
1335 #if defined(__WXPALMOS__)
1336     // TODO ?
1337     return NULL;
1338 #elif defined(__WXWINCE__)
1339     // TODO
1340     wxUnusedVar(buf);
1341     wxUnusedVar(sz);
1342     return NULL;
1343 #else
1344     if ( !buf )
1345     {
1346         buf = new wxChar[sz + 1];
1347     }
1348
1349     bool ok wxDUMMY_INITIALIZE(false);
1350
1351     // for the compilers which have Unicode version of _getcwd(), call it
1352     // directly, for the others call the ANSI version and do the translation
1353 #if !wxUSE_UNICODE
1354     #define cbuf buf
1355 #else // wxUSE_UNICODE
1356     bool needsANSI = true;
1357
1358     #if !defined(HAVE_WGETCWD) || wxUSE_UNICODE_MSLU
1359         // This is not legal code as the compiler
1360         // is allowed destroy the wxCharBuffer.
1361         // wxCharBuffer c_buffer(sz);
1362         // char *cbuf = (char*)(const char*)c_buffer;
1363         char cbuf[_MAXPATHLEN];
1364     #endif
1365
1366     #ifdef HAVE_WGETCWD
1367         #if wxUSE_UNICODE_MSLU
1368             if ( wxGetOsVersion() != wxWIN95 )
1369         #else
1370             char *cbuf = NULL; // never really used because needsANSI will always be false
1371         #endif
1372             {
1373                 ok = _wgetcwd(buf, sz) != NULL;
1374                 needsANSI = false;
1375             }
1376     #endif
1377
1378     if ( needsANSI )
1379 #endif // wxUSE_UNICODE
1380     {
1381     #if defined(_MSC_VER) || defined(__MINGW32__)
1382         ok = _getcwd(cbuf, sz) != NULL;
1383     #elif defined(__WXMAC__) && !defined(__DARWIN__)
1384         char lbuf[1024] ;
1385         if ( getcwd( lbuf , sizeof( lbuf ) ) )
1386         {
1387             wxString res( lbuf , *wxConvCurrent ) ;
1388             wxStrcpy( buf , res ) ;
1389             ok = true;
1390         }
1391         else
1392             ok = false ;
1393     #elif defined(__OS2__)
1394         APIRET rc;
1395         ULONG ulDriveNum = 0;
1396         ULONG ulDriveMap = 0;
1397         rc = ::DosQueryCurrentDisk(&ulDriveNum, &ulDriveMap);
1398         ok = rc == 0;
1399         if (ok)
1400         {
1401             sz -= 3;
1402             rc = ::DosQueryCurrentDir( 0 // current drive
1403                                       ,cbuf + 3
1404                                       ,(PULONG)&sz
1405                                      );
1406             cbuf[0] = 'A' + (ulDriveNum - 1);
1407             cbuf[1] = ':';
1408             cbuf[2] = '\\';
1409             ok = rc == 0;
1410         }
1411     #else // !Win32/VC++ !Mac !OS2
1412         ok = getcwd(cbuf, sz) != NULL;
1413     #endif // platform
1414
1415     #if wxUSE_UNICODE && !(defined(__WXMAC__) && !defined(__DARWIN__))
1416         // finally convert the result to Unicode if needed
1417         wxConvFile.MB2WC(buf, cbuf, sz);
1418     #endif // wxUSE_UNICODE
1419     }
1420
1421     if ( !ok )
1422     {
1423         wxLogSysError(_("Failed to get the working directory"));
1424
1425         // VZ: the old code used to return "." on error which didn't make any
1426         //     sense at all to me - empty string is a better error indicator
1427         //     (NULL might be even better but I'm afraid this could lead to
1428         //     problems with the old code assuming the return is never NULL)
1429         buf[0] = _T('\0');
1430     }
1431     else // ok, but we might need to massage the path into the right format
1432     {
1433 #ifdef __DJGPP__
1434         // VS: DJGPP is a strange mix of DOS and UNIX API and returns paths
1435         //     with / deliminers. We don't like that.
1436         for (wxChar *ch = buf; *ch; ch++)
1437         {
1438             if (*ch == wxT('/'))
1439                 *ch = wxT('\\');
1440         }
1441 #endif // __DJGPP__
1442
1443 // MBN: we hope that in the case the user is compiling a GTK+/Motif app,
1444 //      he needs Unix as opposed to Win32 pathnames
1445 #if defined( __CYGWIN__ ) && defined( __WINDOWS__ )
1446         // another example of DOS/Unix mix (Cygwin)
1447         wxString pathUnix = buf;
1448         cygwin_conv_to_full_win32_path(pathUnix, buf);
1449 #endif // __CYGWIN__
1450     }
1451
1452     return buf;
1453
1454 #if !wxUSE_UNICODE
1455     #undef cbuf
1456 #endif
1457
1458 #endif
1459     // __WXWINCE__
1460 }
1461
1462 wxString wxGetCwd()
1463 {
1464     wxChar *buffer = new wxChar[_MAXPATHLEN];
1465     wxGetWorkingDirectory(buffer, _MAXPATHLEN);
1466     wxString str( buffer );
1467     delete [] buffer;
1468
1469     return str;
1470 }
1471
1472 bool wxSetWorkingDirectory(const wxString& d)
1473 {
1474 #if defined(__OS2__)
1475     return (::DosSetCurrentDir((PSZ)d.c_str()) == 0);
1476 #elif defined(__UNIX__) || defined(__WXMAC__) || defined(__DOS__)
1477     return (chdir(wxFNSTRINGCAST d.fn_str()) == 0);
1478 #elif defined(__WINDOWS__)
1479
1480 #ifdef __WIN32__
1481 #ifdef __WXWINCE__
1482     // No equivalent in WinCE
1483     wxUnusedVar(d);
1484     return false;
1485 #else
1486     return (bool)(SetCurrentDirectory(d) != 0);
1487 #endif
1488 #else
1489     // Must change drive, too.
1490     bool isDriveSpec = ((strlen(d) > 1) && (d[1] == ':'));
1491     if (isDriveSpec)
1492     {
1493         wxChar firstChar = d[0];
1494
1495         // To upper case
1496         if (firstChar > 90)
1497             firstChar = firstChar - 32;
1498
1499         // To a drive number
1500         unsigned int driveNo = firstChar - 64;
1501         if (driveNo > 0)
1502         {
1503             unsigned int noDrives;
1504             _dos_setdrive(driveNo, &noDrives);
1505         }
1506     }
1507     bool success = (chdir(WXSTRINGCAST d) == 0);
1508
1509     return success;
1510 #endif
1511
1512 #endif
1513 }
1514
1515 // Get the OS directory if appropriate (such as the Windows directory).
1516 // On non-Windows platform, probably just return the empty string.
1517 wxString wxGetOSDirectory()
1518 {
1519 #ifdef __WXWINCE__
1520     return wxString(wxT("\\Windows"));
1521 #elif defined(__WINDOWS__) && !defined(__WXMICROWIN__)
1522     wxChar buf[256];
1523     GetWindowsDirectory(buf, 256);
1524     return wxString(buf);
1525 #elif defined(__WXMAC__)
1526     return wxMacFindFolder(kOnSystemDisk, 'macs', false);
1527 #else
1528     return wxEmptyString;
1529 #endif
1530 }
1531
1532 bool wxEndsWithPathSeparator(const wxChar *pszFileName)
1533 {
1534     size_t len = wxStrlen(pszFileName);
1535
1536     return len && wxIsPathSeparator(pszFileName[len - 1]);
1537 }
1538
1539 // find a file in a list of directories, returns false if not found
1540 bool wxFindFileInPath(wxString *pStr, const wxChar *pszPath, const wxChar *pszFile)
1541 {
1542     // we assume that it's not empty
1543     wxCHECK_MSG( !wxIsEmpty(pszFile), false,
1544                  _T("empty file name in wxFindFileInPath"));
1545
1546     // skip path separator in the beginning of the file name if present
1547     if ( wxIsPathSeparator(*pszFile) )
1548         pszFile++;
1549
1550     // copy the path (strtok will modify it)
1551     wxChar *szPath = new wxChar[wxStrlen(pszPath) + 1];
1552     wxStrcpy(szPath, pszPath);
1553
1554     wxString strFile;
1555     wxChar *pc, *save_ptr;
1556     for ( pc = wxStrtok(szPath, wxPATH_SEP, &save_ptr);
1557           pc != NULL;
1558           pc = wxStrtok((wxChar *) NULL, wxPATH_SEP, &save_ptr) )
1559     {
1560         // search for the file in this directory
1561         strFile = pc;
1562         if ( !wxEndsWithPathSeparator(pc) )
1563             strFile += wxFILE_SEP_PATH;
1564         strFile += pszFile;
1565
1566         if ( wxFileExists(strFile) ) {
1567             *pStr = strFile;
1568             break;
1569         }
1570     }
1571
1572     // suppress warning about unused variable save_ptr when wxStrtok() is a
1573     // macro which throws away its third argument
1574     save_ptr = pc;
1575
1576     delete [] szPath;
1577
1578     return pc != NULL;  // if true => we breaked from the loop
1579 }
1580
1581 void WXDLLEXPORT wxSplitPath(const wxChar *pszFileName,
1582                              wxString *pstrPath,
1583                              wxString *pstrName,
1584                              wxString *pstrExt)
1585 {
1586     // it can be empty, but it shouldn't be NULL
1587     wxCHECK_RET( pszFileName, wxT("NULL file name in wxSplitPath") );
1588
1589     wxFileName::SplitPath(pszFileName, pstrPath, pstrName, pstrExt);
1590 }
1591
1592 time_t WXDLLEXPORT wxFileModificationTime(const wxString& filename)
1593 {
1594 #if defined(__WXPALMOS__)
1595     return 0;
1596 #elif defined(__WXWINCE__)
1597     FILETIME creationTime, lastAccessTime, lastWriteTime;
1598     HANDLE fileHandle = ::CreateFile(filename, GENERIC_READ, FILE_SHARE_READ, NULL,
1599         0, FILE_ATTRIBUTE_NORMAL, 0);
1600     if (fileHandle == INVALID_HANDLE_VALUE)
1601         return 0;
1602     else
1603     {
1604         if (GetFileTime(fileHandle, & creationTime, & lastAccessTime, & lastWriteTime))
1605         {
1606             CloseHandle(fileHandle);
1607
1608             wxDateTime dateTime;
1609             FILETIME ftLocal;
1610             if ( !::FileTimeToLocalFileTime(&lastWriteTime, &ftLocal) )
1611             {
1612                 wxLogLastError(_T("FileTimeToLocalFileTime"));
1613             }
1614
1615             SYSTEMTIME st;
1616             if ( !::FileTimeToSystemTime(&ftLocal, &st) )
1617             {
1618                 wxLogLastError(_T("FileTimeToSystemTime"));
1619             }
1620
1621             dateTime.Set(st.wDay, wxDateTime::Month(st.wMonth - 1), st.wYear,
1622                 st.wHour, st.wMinute, st.wSecond, st.wMilliseconds);
1623             return dateTime.GetTicks();
1624         }
1625         else
1626             return 0;
1627     }
1628 #else
1629     wxStructStat buf;
1630     wxStat( filename, &buf);
1631
1632     return buf.st_mtime;
1633 #endif
1634 }
1635
1636
1637 // Parses the filterStr, returning the number of filters.
1638 // Returns 0 if none or if there's a problem.
1639 // filterStr is in the form: "All files (*.*)|*.*|JPEG Files (*.jpeg)|*.jpeg"
1640
1641 int WXDLLEXPORT wxParseCommonDialogsFilter(const wxString& filterStr, wxArrayString& descriptions, wxArrayString& filters)
1642 {
1643     descriptions.Clear();
1644     filters.Clear();
1645
1646     wxString str(filterStr);
1647
1648     wxString description, filter;
1649     int pos = 0;
1650     while( pos != wxNOT_FOUND )
1651     {
1652         pos = str.Find(wxT('|'));
1653         if ( pos == wxNOT_FOUND )
1654         {
1655             // if there are no '|'s at all in the string just take the entire
1656             // string as filter and make description empty for later autocompletion
1657             if ( filters.IsEmpty() )
1658             {
1659                 descriptions.Add(wxEmptyString);
1660                 filters.Add(filterStr);
1661             }
1662             else
1663             {
1664                 wxFAIL_MSG( _T("missing '|' in the wildcard string!") );
1665             }
1666
1667             break;
1668         }
1669
1670         description = str.Left(pos);
1671         str = str.Mid(pos + 1);
1672         pos = str.Find(wxT('|'));
1673         if ( pos == wxNOT_FOUND )
1674         {
1675             filter = str;
1676         }
1677         else
1678         {
1679             filter = str.Left(pos);
1680             str = str.Mid(pos + 1);
1681         }
1682
1683         descriptions.Add(description);
1684         filters.Add(filter);
1685     }
1686
1687 #if defined(__WXMOTIF__)
1688     // split it so there is one wildcard per entry
1689     for( size_t i = 0 ; i < descriptions.GetCount() ; i++ )
1690     {
1691         pos = filters[i].Find(wxT(';'));
1692         if (pos != wxNOT_FOUND)
1693         {
1694             // first split only filters
1695             descriptions.Insert(descriptions[i],i+1);
1696             filters.Insert(filters[i].Mid(pos+1),i+1);
1697             filters[i]=filters[i].Left(pos);
1698
1699             // autoreplace new filter in description with pattern:
1700             //     C/C++ Files(*.cpp;*.c;*.h)|*.cpp;*.c;*.h
1701             // cause split into:
1702             //     C/C++ Files(*.cpp)|*.cpp
1703             //     C/C++ Files(*.c;*.h)|*.c;*.h
1704             // and next iteration cause another split into:
1705             //     C/C++ Files(*.cpp)|*.cpp
1706             //     C/C++ Files(*.c)|*.c
1707             //     C/C++ Files(*.h)|*.h
1708             for ( size_t k=i;k<i+2;k++ )
1709             {
1710                 pos = descriptions[k].Find(filters[k]);
1711                 if (pos != wxNOT_FOUND)
1712                 {
1713                     wxString before = descriptions[k].Left(pos);
1714                     wxString after = descriptions[k].Mid(pos+filters[k].Len());
1715                     pos = before.Find(_T('('),true);
1716                     if (pos>before.Find(_T(')'),true))
1717                     {
1718                         before = before.Left(pos+1);
1719                         before << filters[k];
1720                         pos = after.Find(_T(')'));
1721                         int pos1 = after.Find(_T('('));
1722                         if (pos != wxNOT_FOUND && (pos<pos1 || pos1==wxNOT_FOUND))
1723                         {
1724                             before << after.Mid(pos);
1725                             descriptions[k] = before;
1726                         }
1727                     }
1728                 }
1729             }
1730         }
1731     }
1732 #endif
1733
1734     // autocompletion
1735     for( size_t j = 0 ; j < descriptions.GetCount() ; j++ )
1736     {
1737         if ( descriptions[j].empty() && !filters[j].empty() )
1738         {
1739             descriptions[j].Printf(_("Files (%s)"), filters[j].c_str());
1740         }
1741     }
1742
1743     return filters.GetCount();
1744 }
1745
1746
1747 //------------------------------------------------------------------------
1748 // wild character routines
1749 //------------------------------------------------------------------------
1750
1751 bool wxIsWild( const wxString& pattern )
1752 {
1753     wxString tmp = pattern;
1754     wxChar *pat = WXSTRINGCAST(tmp);
1755     while (*pat)
1756     {
1757         switch (*pat++)
1758         {
1759         case wxT('?'): case wxT('*'): case wxT('['): case wxT('{'):
1760             return true;
1761         case wxT('\\'):
1762             if (!*pat++)
1763                 return false;
1764         }
1765     }
1766     return false;
1767 }
1768
1769 /*
1770 * Written By Douglas A. Lewis <dalewis@cs.Buffalo.EDU>
1771 *
1772 * The match procedure is public domain code (from ircII's reg.c)
1773 */
1774
1775 bool wxMatchWild( const wxString& pat, const wxString& text, bool dot_special )
1776 {
1777         if (text.empty())
1778         {
1779                 /* Match if both are empty. */
1780                 return pat.empty();
1781         }
1782
1783         const wxChar *m = pat.c_str(),
1784         *n = text.c_str(),
1785         *ma = NULL,
1786         *na = NULL,
1787         *mp = NULL,
1788         *np = NULL;
1789         int just = 0,
1790         pcount = 0,
1791         acount = 0,
1792         count = 0;
1793
1794         if (dot_special && (*n == wxT('.')))
1795         {
1796                 /* Never match so that hidden Unix files
1797                  * are never found. */
1798                 return false;
1799         }
1800
1801         for (;;)
1802         {
1803                 if (*m == wxT('*'))
1804                 {
1805                         ma = ++m;
1806                         na = n;
1807                         just = 1;
1808                         mp = NULL;
1809                         acount = count;
1810                 }
1811                 else if (*m == wxT('?'))
1812                 {
1813                         m++;
1814                         if (!*n++)
1815                         return false;
1816                 }
1817                 else
1818                 {
1819                         if (*m == wxT('\\'))
1820                         {
1821                                 m++;
1822                                 /* Quoting "nothing" is a bad thing */
1823                                 if (!*m)
1824                                 return false;
1825                         }
1826                         if (!*m)
1827                         {
1828                                 /*
1829                                 * If we are out of both strings or we just
1830                                 * saw a wildcard, then we can say we have a
1831                                 * match
1832                                 */
1833                                 if (!*n)
1834                                 return true;
1835                                 if (just)
1836                                 return true;
1837                                 just = 0;
1838                                 goto not_matched;
1839                         }
1840                         /*
1841                         * We could check for *n == NULL at this point, but
1842                         * since it's more common to have a character there,
1843                         * check to see if they match first (m and n) and
1844                         * then if they don't match, THEN we can check for
1845                         * the NULL of n
1846                         */
1847                         just = 0;
1848                         if (*m == *n)
1849                         {
1850                                 m++;
1851                                 if (*n == wxT(' '))
1852                                 mp = NULL;
1853                                 count++;
1854                                 n++;
1855                         }
1856                         else
1857                         {
1858
1859                                 not_matched:
1860
1861                                 /*
1862                                 * If there are no more characters in the
1863                                 * string, but we still need to find another
1864                                 * character (*m != NULL), then it will be
1865                                 * impossible to match it
1866                                 */
1867                                 if (!*n)
1868                                 return false;
1869                                 if (mp)
1870                                 {
1871                                         m = mp;
1872                                         if (*np == wxT(' '))
1873                                         {
1874                                                 mp = NULL;
1875                                                 goto check_percent;
1876                                         }
1877                                         n = ++np;
1878                                         count = pcount;
1879                                 }
1880                                 else
1881                                 check_percent:
1882
1883                                 if (ma)
1884                                 {
1885                                         m = ma;
1886                                         n = ++na;
1887                                         count = acount;
1888                                 }
1889                                 else
1890                                 return false;
1891                         }
1892                 }
1893         }
1894 }
1895
1896 // Return the type of an open file
1897 //
1898 // Some file types on some platforms seem seekable but in fact are not.
1899 // The main use of this function is to allow such cases to be detected
1900 // (IsSeekable() is implemented as wxGetFileKind() == wxFILE_KIND_DISK).
1901 //
1902 // This is important for the archive streams, which benefit greatly from
1903 // being able to seek on a stream, but which will produce corrupt archives
1904 // if they unknowingly seek on a non-seekable stream.
1905 //
1906 // wxFILE_KIND_DISK is a good catch all return value, since other values
1907 // disable features of the archive streams. Some other value must be returned
1908 // for a file type that appears seekable but isn't.
1909 //
1910 // Known examples:
1911 //   *  Pipes on Windows
1912 //   *  Files on VMS with a record format other than StreamLF
1913 //
1914 wxFileKind wxGetFileKind(int fd)
1915 {
1916 #if defined __WXMSW__ && !defined __WXWINCE__ && defined wxGetOSFHandle
1917     switch (::GetFileType(wxGetOSFHandle(fd)) & ~FILE_TYPE_REMOTE)
1918     {
1919         case FILE_TYPE_CHAR:
1920             return wxFILE_KIND_TERMINAL;
1921         case FILE_TYPE_DISK:
1922             return wxFILE_KIND_DISK;
1923         case FILE_TYPE_PIPE:
1924             return wxFILE_KIND_PIPE;
1925     }
1926
1927     return wxFILE_KIND_UNKNOWN;
1928
1929 #elif defined(__UNIX__)
1930     if (isatty(fd))
1931         return wxFILE_KIND_TERMINAL;
1932
1933     struct stat st;
1934     fstat(fd, &st);
1935
1936     if (S_ISFIFO(st.st_mode))
1937         return wxFILE_KIND_PIPE;
1938     if (!S_ISREG(st.st_mode))
1939         return wxFILE_KIND_UNKNOWN;
1940
1941     #if defined(__VMS__)
1942         if (st.st_fab_rfm != FAB$C_STMLF)
1943             return wxFILE_KIND_UNKNOWN;
1944     #endif
1945
1946     return wxFILE_KIND_DISK;
1947
1948 #else
1949     #define wxFILEKIND_STUB
1950     (void)fd;
1951     return wxFILE_KIND_DISK;
1952 #endif
1953 }
1954
1955 wxFileKind wxGetFileKind(FILE *fp)
1956 {
1957     // note: the watcom rtl dll doesn't have fileno (the static lib does)
1958 #if !defined wxFILEKIND_STUB && !(defined __WATCOMC__ && defined __SW_BR)
1959     return wxGetFileKind(fileno(fp));
1960 #else
1961     (void)fp;
1962     return wxFILE_KIND_DISK;
1963 #endif
1964 }
1965
1966 #ifdef __VISUALC__
1967     #pragma warning(default:4706)   // assignment within conditional expression
1968 #endif // VC++