AuroraMiddleware/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

clarified the rules for determining whether the path is absolute or relative (patch 1451229 and bug 1438196)

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@38769 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin 2006-04-16 22:44:19 +00:00
parent 432ea998aa
commit 47ce5c4a5a
1 changed files with 17 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
docs/latex/wx/filename.tex
View File

@ -73,20 +73,23 @@ state and \helpref{IsOk}{wxfilenameisok} returns {\tt false} for it.
File names can be case-sensitive or not, the function\rtfsp File names can be case-sensitive or not, the function\rtfsp
\helpref{IsCaseSensitive}{wxfilenameiscasesensitive} allows to determine this. \helpref{IsCaseSensitive}{wxfilenameiscasesensitive} allows to determine this.
The rules for determining if the file name is absolute or relative also depends The rules for determining whether the file name is absolute or relative also
on the file name format and the only portable way to answer to this question is depend on the file name format and the only portable way to answer this
to use \helpref{IsAbsolute}{wxfilenameisabsolute} method. To ensure that the question is to use \helpref{IsAbsolute}{wxfilenameisabsolute} or\rtfsp
filename is absolute you may use \helpref{MakeAbsolute}{wxfilenamemakeabsolute}. \helpref{IsRelative}{wxfilenameisrelative} method. Note that on Windows, "X:"
There is also an inverse function refers to the current working directory on drive X. Therefore, a wxFileName
\helpref{MakeRelativeTo}{wxfilenamemakerelativeto} which undoes what instance constructed from for example "X:dir/file.ext" treats the portion
\helpref{Normalize(wxPATH\_NORM\_DOTS)}{wxfilenamenormalize} does. beyond drive separator as being relative to that directory.
To ensure that the filename is absolute, you may use\rtfsp
\helpref{MakeAbsolute}{wxfilenamemakeabsolute}. There is also an inverse
function \helpref{MakeRelativeTo}{wxfilenamemakerelativeto} which undoes
what \helpref{Normalize(wxPATH\_NORM\_DOTS)}{wxfilenamenormalize} does.
Other functions returning information about the file format provided by this Other functions returning information about the file format provided by this
class are \helpref{GetVolumeSeparator}{wxfilenamegetvolumeseparator},\rtfsp class are \helpref{GetVolumeSeparator}{wxfilenamegetvolumeseparator},\rtfsp
\helpref{IsPathSeparator}{wxfilenameispathseparator}. \helpref{IsPathSeparator}{wxfilenameispathseparator}.
\helpref{IsRelative}{wxfilenameisrelative}
\membersection{File name construction}\label{filenameconstruction} \membersection{File name construction}\label{filenameconstruction}
@ -95,11 +98,11 @@ TODO.
\membersection{File tests}\label{filetests} \membersection{File tests}\label{filetests}
Before doing the other tests you should use \helpref{IsOk}{wxfilenameisok} to Before doing other tests, you should use \helpref{IsOk}{wxfilenameisok} to
verify that the filename is well defined. If it is, verify that the filename is well defined. If it is,\rtfsp
\helpref{FileExists}{wxfilenamefileexists} can be used to test if a file with \helpref{FileExists}{wxfilenamefileexists} can be used to test whether a file
such name exists and \helpref{DirExists}{wxfilenamedirexists} - if a directory with such name exists and \helpref{DirExists}{wxfilenamedirexists} can be used
with this name exists. to test for directory existence.
File names should be compared using \helpref{SameAs}{wxfilenamesameas} method File names should be compared using \helpref{SameAs}{wxfilenamesameas} method
or \helpref{$==$}{wxfilenameoperatorequal}. or \helpref{$==$}{wxfilenameoperatorequal}.