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