1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxFile - encapsulates low-level "file descriptor"
5 // Author: Vadim Zeitlin
9 // Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
10 // Licence: wxWindows license
11 /////////////////////////////////////////////////////////////////////////////
13 // ----------------------------------------------------------------------------
15 // ----------------------------------------------------------------------------
18 #pragma implementation "file.h"
21 // For compilers that support precompilation, includes "wx.h".
22 #include "wx/wxprec.h"
31 #if defined(__WXMSW__) && !defined(__GNUWIN32__) && !defined(__WXWINE__) && !defined(__WXMICROWIN__)
35 #define WIN32_LEAN_AND_MEAN
57 #include <windows.h> // for GetTempFileName
58 #elif (defined(__UNIX__) || defined(__GNUWIN32__))
63 #elif (defined(__WXPM__))
67 #elif (defined(__WXSTUBS__))
68 // Have to ifdef this for different environments
70 #elif (defined(__WXMAC__))
72 int access( const char *path
, int mode
) { return 0 ; }
74 int _access( const char *path
, int mode
) { return 0 ; }
76 char* mktemp( char * path
) { return path
;}
82 #error "Please specify the header with file functions declarations."
85 #include <stdio.h> // SEEK_xxx constants
86 #include <fcntl.h> // O_RDONLY &c
89 #include <sys/types.h> // needed for stat
90 #include <sys/stat.h> // stat
91 #elif ( defined(__MWERKS__) && defined(__WXMSW__) )
92 #include <sys/types.h> // needed for stat
93 #include <sys/stat.h> // stat
96 #if defined(__BORLANDC__) || defined(_MSC_VER)
101 // there is no distinction between text and binary files under Unix, so define
102 // O_BINARY as 0 if the system headers don't do it already
103 #if defined(__UNIX__) && !defined(O_BINARY)
115 // some broken compilers don't have 3rd argument in open() and creat()
117 #define ACCESS(access)
119 #else // normal compiler
120 #define ACCESS(access) , (access)
124 #include "wx/string.h"
129 // ============================================================================
130 // implementation of wxFile
131 // ============================================================================
133 // ----------------------------------------------------------------------------
135 // ----------------------------------------------------------------------------
136 bool wxFile
::Exists(const wxChar
*name
)
139 #if wxUSE_UNICODE && wxMBFILES
140 wxCharBuffer fname
= wxConvFile
.cWC2MB(name
);
142 return !wxAccess(fname
, 0) &&
143 !wxStat(wxMBSTRINGCAST fname
, &st
) &&
144 (st
.st_mode
& S_IFREG
);
147 return !wxAccess(name
, 0) &&
148 !wxStat(name
, &st
) &&
149 (st
.st_mode
& S_IFREG
);
153 bool wxFile
::Access(const wxChar
*name
, OpenMode mode
)
167 wxFAIL_MSG(wxT("bad wxFile::Access mode parameter."));
170 return wxAccess(wxFNCONV(name
), how
) == 0;
173 // ----------------------------------------------------------------------------
175 // ----------------------------------------------------------------------------
178 wxFile
::wxFile(const wxChar
*szFileName
, OpenMode mode
)
183 Open(szFileName
, mode
);
186 // create the file, fail if it already exists and bOverwrite
187 bool wxFile
::Create(const wxChar
*szFileName
, bool bOverwrite
, int accessMode
)
189 // if bOverwrite we create a new file or truncate the existing one,
190 // otherwise we only create the new file and fail if it already exists
191 #if defined(__WXMAC__) && !defined(__UNIX__)
192 // Dominic Mazzoni [dmazzoni+@cs.cmu.edu] reports that open is still broken on the mac, so we replace
193 // int fd = open(wxUnix2MacFilename( szFileName ), O_CREAT | (bOverwrite ? O_TRUNC : O_EXCL), access);
194 int fd
= creat( szFileName
, accessMode
);
196 int fd
= wxOpen(wxFNCONV(szFileName
),
197 O_BINARY
| O_WRONLY
| O_CREAT
|
198 (bOverwrite ? O_TRUNC
: O_EXCL
)
202 wxLogSysError(_("can't create file '%s'"), szFileName
);
212 bool wxFile
::Open(const wxChar
*szFileName
, OpenMode mode
, int accessMode
)
214 int flags
= O_BINARY
;
222 if ( wxFile
::Exists(szFileName
) )
224 flags
|= O_WRONLY
| O_APPEND
;
227 //else: fall through as write_append is the same as write if the
228 // file doesn't exist
231 flags
|= O_WRONLY
| O_CREAT
| O_TRUNC
;
235 flags
|= O_WRONLY
| O_CREAT
| O_EXCL
;
243 int fd
= wxOpen(wxFNCONV(szFileName
), flags
ACCESS(accessMode
));
245 wxLogSysError(_("can't open file '%s'"), szFileName
);
258 if ( close(m_fd
) == -1 ) {
259 wxLogSysError(_("can't close file descriptor %d"), m_fd
);
270 // ----------------------------------------------------------------------------
272 // ----------------------------------------------------------------------------
275 off_t wxFile
::Read(void *pBuf
, off_t nCount
)
277 wxCHECK( (pBuf
!= NULL
) && IsOpened(), 0 );
280 int iRc
= ::read(m_fd
, (char*) pBuf
, nCount
);
282 int iRc
= ::read(m_fd
, pBuf
, nCount
);
285 wxLogSysError(_("can't read from file descriptor %d"), m_fd
);
286 return wxInvalidOffset
;
293 size_t wxFile
::Write(const void *pBuf
, size_t nCount
)
295 wxCHECK( (pBuf
!= NULL
) && IsOpened(), 0 );
298 #if __MSL__ >= 0x6000
299 int iRc
= ::write(m_fd
, (void*) pBuf
, nCount
);
301 int iRc
= ::write(m_fd
, (const char*) pBuf
, nCount
);
304 int iRc
= ::write(m_fd
, pBuf
, nCount
);
307 wxLogSysError(_("can't write to file descriptor %d"), m_fd
);
319 #if defined(__VISUALC__) || wxHAVE_FSYNC
320 if ( wxFsync(m_fd
) == -1 )
322 wxLogSysError(_("can't flush file descriptor %d"), m_fd
);
333 // ----------------------------------------------------------------------------
335 // ----------------------------------------------------------------------------
338 off_t wxFile
::Seek(off_t ofs
, wxSeekMode mode
)
340 wxASSERT( IsOpened() );
345 wxFAIL_MSG(_("unknown seek origin"));
360 int iRc
= lseek(m_fd
, ofs
, origin
);
362 wxLogSysError(_("can't seek on file descriptor %d"), m_fd
);
363 return wxInvalidOffset
;
370 off_t wxFile
::Tell() const
372 wxASSERT( IsOpened() );
374 int iRc
= wxTell(m_fd
);
376 wxLogSysError(_("can't get seek position on file descriptor %d"), m_fd
);
377 return wxInvalidOffset
;
383 // get current file length
384 off_t wxFile
::Length() const
386 wxASSERT( IsOpened() );
389 int iRc
= _filelength(m_fd
);
391 int iRc
= wxTell(m_fd
);
393 // @ have to use const_cast :-(
394 int iLen
= ((wxFile
*)this)->SeekEnd();
396 // restore old position
397 if ( ((wxFile
*)this)->Seek(iRc
) == -1 ) {
408 wxLogSysError(_("can't find length of file on file descriptor %d"), m_fd
);
409 return wxInvalidOffset
;
415 // is end of file reached?
416 bool wxFile
::Eof() const
418 wxASSERT( IsOpened() );
422 #if defined(__UNIX__) || defined(__GNUWIN32__) || defined( __MWERKS__ ) || defined(__SALFORDC__)
423 // @@ this doesn't work, of course, on unseekable file descriptors
424 off_t ofsCur
= Tell(),
426 if ( ofsCur
== wxInvalidOffset
|| ofsMax
== wxInvalidOffset
)
429 iRc
= ofsCur
== ofsMax
;
430 #else // Windows and "native" compiler
432 #endif // Windows/Unix
442 wxLogSysError(_("can't determine if the end of file is reached on descriptor %d"), m_fd
);
446 wxFAIL_MSG(_("invalid eof() return value."));
452 // ============================================================================
453 // implementation of wxTempFile
454 // ============================================================================
456 // ----------------------------------------------------------------------------
458 // ----------------------------------------------------------------------------
459 wxTempFile
::wxTempFile(const wxString
& strName
)
464 bool wxTempFile
::Open(const wxString
& strName
)
468 // we want to create the file in the same directory as strName because
469 // otherwise rename() in Commit() might not work (if the files are on
470 // different partitions for example). Unfortunately, the only standard
471 // (POSIX) temp file creation function tmpnam() can't do it.
472 #if defined(__UNIX__) || defined(__WXSTUBS__)|| defined( __WXMAC__ )
473 static const wxChar
*szMktempSuffix
= wxT("XXXXXX");
474 m_strTemp
<< strName
<< szMktempSuffix
;
475 // can use the cast because length doesn't change
476 mktemp(wxMBSTRINGCAST m_strTemp
.mb_str());
477 #elif defined(__WXPM__)
478 // for now just create a file
479 // future enhancements can be to set some extended attributes for file systems
480 // OS/2 supports that have them (HPFS, FAT32) and security (HPFS386)
481 static const wxChar
*szMktempSuffix
= wxT("XXX");
482 m_strTemp
<< strName
<< szMktempSuffix
;
483 // Temporarily remove - MN
485 ::DosCreateDir(m_strTemp
.GetWriteBuf(MAX_PATH
), NULL
);
489 wxSplitPath(strName
, &strPath
, NULL
, NULL
);
490 if ( strPath
.IsEmpty() )
491 strPath
= wxT('.'); // GetTempFileName will fail if we give it empty string
493 if ( !GetTempFileName(strPath
, wxT("wx_"),0, m_strTemp
.GetWriteBuf(MAX_PATH
)) )
495 // Not sure why MSVC++ 1.5 header defines first param as BYTE - bug?
496 if ( !GetTempFileName((BYTE
) (DWORD
)(const wxChar
*) strPath
, wxT("wx_"),0, m_strTemp
.GetWriteBuf(MAX_PATH
)) )
498 wxLogLastError(wxT("GetTempFileName"));
499 m_strTemp
.UngetWriteBuf();
500 #endif // Windows/Unix
502 int access
= wxS_DEFAULT
;
504 // create the file with the same mode as the original one under Unix
505 mode_t umaskOld
= 0; // just to suppress compiler warning
509 if ( stat(strName
.fn_str(), &st
) == 0 )
511 // this assumes that only lower bits of st_mode contain the access
512 // rights, but it's true for at least all Unices which have S_IXXXX()
513 // macros, so should not be less portable than using (not POSIX)
515 access
= st
.st_mode
& 0777;
517 // we want to create the file with exactly the same access rights as
518 // the original one, so disable the user's umask for the moment
524 // file probably didn't exist, just create with default mode _using_
525 // user's umask (new files creation should respect umask)
526 changedUmask
= FALSE
;
530 // Open this file securely, since it surely should not exist unless
531 // nefarious activities (or other random bad things) are at play.
533 bool ok
= m_file
.Open(m_strTemp
, wxFile
::write_excl
, access
);
535 // FIXME: If !ok here should we loop and try again with another file
536 // name? That is the standard recourse if open(O_EXCL) fails,
537 // though of course it should be protected against possible
538 // infinite looping too.
543 // restore umask now that the file is created
544 (void)umask(umaskOld
);
551 // ----------------------------------------------------------------------------
553 // ----------------------------------------------------------------------------
555 wxTempFile
::~wxTempFile()
561 bool wxTempFile
::Commit()
565 if ( wxFile
::Exists(m_strName
) && wxRemove(m_strName
) != 0 ) {
566 wxLogSysError(_("can't remove file '%s'"), m_strName
.c_str());
570 if ( wxRename(m_strTemp
, m_strName
) != 0 ) {
571 wxLogSysError(_("can't commit changes to file '%s'"), m_strName
.c_str());
578 void wxTempFile
::Discard()
581 if ( wxRemove(m_strTemp
) != 0 )
582 wxLogSysError(_("can't remove temporary file '%s'"), m_strTemp
.c_str());