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