]>
Commit | Line | Data |
---|---|---|
1 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% | |
2 | %% Name: filename.tex | |
3 | %% Purpose: wxFileName documentation | |
4 | %% Author: Vadim Zeitlin | |
5 | %% Modified by: | |
6 | %% Created: 30.11.01 | |
7 | %% RCS-ID: $Id$ | |
8 | %% Copyright: (c) 2001 Vadim Zeitlin | |
9 | %% License: wxWindows license | |
10 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% | |
11 | ||
12 | \section{\class{wxFileName}}\label{wxfilename} | |
13 | ||
14 | wxFileName encapsulates a file name. This class serves two purposes: first, it | |
15 | provides the functions to split the file names into components and to recombine | |
16 | these components in the full file name which can then be passed to the OS file | |
17 | functions (and \helpref{wxWindows functions}{filefunctions} wrapping them). | |
18 | Second, it includes the functions for working with the files itself. Note that | |
19 | to change the file data you should use \helpref{wxFile}{wxfile} class instead, | |
20 | wxFileName provides functions for working with the file attributes. | |
21 | ||
22 | \wxheading{Derived from} | |
23 | ||
24 | No base class | |
25 | ||
26 | \wxheading{Data structures} | |
27 | ||
28 | Many wxFileName methods accept the path format argument which is by\rtfsp | |
29 | {\tt wxPATH\_NATIVE} by default meaning to use the path format native for the | |
30 | current platform. | |
31 | ||
32 | The path format affects the operation of wxFileName functions in several ways: | |
33 | first and foremost, it defines the path separator character to use, but it also | |
34 | affects other things such as whether the path has the drive part or not. | |
35 | ||
36 | \begin{verbatim} | |
37 | enum wxPathFormat | |
38 | { | |
39 | wxPATH_NATIVE = 0, // the path format for the current platform | |
40 | wxPATH_UNIX, | |
41 | wxPATH_MAC, | |
42 | wxPATH_DOS, | |
43 | wxPATH_VMS, | |
44 | ||
45 | wxPATH_BEOS = wxPATH_UNIX, | |
46 | wxPATH_WIN = wxPATH_DOS, | |
47 | wxPATH_OS2 = wxPATH_DOS | |
48 | } | |
49 | \end{verbatim} | |
50 | ||
51 | The kind of normalization to do with the file name: these values can be | |
52 | or'd together to perform several operations at once in\rtfsp | |
53 | \helpref{Normalize}{wxfilenamenormalize}. | |
54 | ||
55 | \begin{verbatim} | |
56 | enum wxPathNormalize | |
57 | { | |
58 | wxPATH_NORM_ENV_VARS = 0x0001, // replace env vars with their values | |
59 | wxPATH_NORM_DOTS = 0x0002, // squeeze all .. and . and prepend cwd | |
60 | wxPATH_NORM_TILDE = 0x0004, // Unix only: replace ~ and ~user | |
61 | wxPATH_NORM_CASE = 0x0008, // if case insensitive => tolower | |
62 | wxPATH_NORM_ABSOLUTE = 0x0010, // make the path absolute | |
63 | wxPATH_NORM_LONG = 0x0020, // make the path the long form | |
64 | wxPATH_NORM_ALL = 0x003f | |
65 | } | |
66 | \end{verbatim} | |
67 | ||
68 | \latexignore{\rtfignore{\wxheading{Function groups}}} | |
69 | ||
70 | \membersection{File name format} | |
71 | ||
72 | wxFileName currently supports the file names in the Unix, DOS/Windows, Mac OS | |
73 | and VMS formats. Although these formats are quite different, wxFileName tries | |
74 | to treat them all in the sam generic way. It supposes that all file names | |
75 | consist of the following parts: the volume (also known as drive under Windows | |
76 | or device under VMS), the path which is a sequence of directory names separated | |
77 | by the \helpref{path separators}{wxfilenamegetpathseparators} and the full | |
78 | filename itself which, in turn, is composed from the base file name and the | |
79 | extension. All of the individual components of the file name may be empty and, | |
80 | for example, the volume name is always empty under Unix, but if they are all | |
81 | empty simultaneously, the filename object is considered to be in an invalid | |
82 | state and \helpref{IsOk}{wxfilenameisok} returns {\tt FALSE} for it. | |
83 | ||
84 | File names can be case-sensitive or not, the function\rtfsp | |
85 | \helpref{IsCaseSensitive}{wxfilenameiscasesensitive} allows to determine this. | |
86 | ||
87 | The rules for determining if the file name is absolute or relative also depends | |
88 | on the file name format and the only portable way to answer to this question is | |
89 | to use \helpref{IsAbsolute}{wxfilenameisabsolute} method. To ensure that the | |
90 | filename is absolute you may use \helpref{Normalize}{wxfilenamenormalize}. There | |
91 | is also an inverse function \helpref{MakeRelativeTo}{wxfilenamemakerelativeto} | |
92 | which undoes what \helpref{Normalize(wxPATH\_NORM\_DOTS}{wxfilenamenormalize} | |
93 | does. | |
94 | ||
95 | Other functions returning information about the file format provided by this | |
96 | class are \helpref{GetVolumeSeparator}{wxfilenamegetvolumeseparator},\rtfsp | |
97 | \helpref{IsPathSeparator}{wxfilenameispathseparator} and\rtfsp | |
98 | \helpref{IsWild}{wxfilenameiswild}. | |
99 | ||
100 | \helpref{IsRelative}{wxfilenameisrelative} | |
101 | ||
102 | \membersection{File name construction} | |
103 | ||
104 | TODO. | |
105 | ||
106 | \membersection{File tests} | |
107 | ||
108 | Before doing the other tests you should use \helpref{IsOk}{wxfilenameisok} to | |
109 | verify that the filename is well defined. If it is, | |
110 | \helpref{FileExists}{wxfilenamefileexists} can be used to test if a file with | |
111 | such name exists and \helpref{DirExists}{wxfilenamedirexists} - if a directory | |
112 | with this name exists. | |
113 | ||
114 | File names should be compared using \helpref{SameAs}{wxfilenamesameas} method | |
115 | or \helpref{$==$}{wxfilenameoperatorequal}. | |
116 | ||
117 | \membersection{File name components} | |
118 | ||
119 | These functions allow to examine and modify the directories of the path: | |
120 | ||
121 | \helpref{AppendDir}{wxfilenameappenddir}\\ | |
122 | \helpref{InsertDir}{wxfilenameinsertdir}\\ | |
123 | \helpref{GetDirCount}{wxfilenamegetdircount} | |
124 | \helpref{PrependDir}{wxfilenameprependdir}\\ | |
125 | \helpref{RemoveDir}{wxfilenameremovedir} | |
126 | ||
127 | To change the components of the file name individually you can use the | |
128 | following functions: | |
129 | ||
130 | \helpref{GetExt}{wxfilenamegetext}\\ | |
131 | \helpref{GetName}{wxfilenamegetname}\\ | |
132 | \helpref{GetVolume}{wxfilenamegetvolume}\\ | |
133 | \helpref{HasExt}{wxfilenamehasext}\\ | |
134 | \helpref{HasName}{wxfilenamehasname}\\ | |
135 | \helpref{HasVolume}{wxfilenamehasvolume}\\ | |
136 | \helpref{SetExt}{wxfilenamesetext}\\ | |
137 | \helpref{SetName}{wxfilenamesetname}\\ | |
138 | \helpref{SetVolume}{wxfilenamesetvolume}\\ | |
139 | ||
140 | \membersection{Operations} | |
141 | ||
142 | These methods allow to work with the file creation, access and modification | |
143 | times: | |
144 | ||
145 | \helpref{GetModificationTime}{wxfilenamegetmodificationtime}\\ | |
146 | \helpref{GetTimes}{wxfilenamegettimes}\\ | |
147 | \helpref{SetTimes}{wxfilenamesettimes}\\ | |
148 | \helpref{Touch}{wxfilenametouch} | |
149 | ||
150 | Other file system operations functions are: | |
151 | ||
152 | \helpref{Mkdir}{wxfilenamemkdir}\\ | |
153 | \helpref{Rmdir}{wxfilenamermdir} | |
154 | ||
155 | \latexignore{\rtfignore{\wxheading{Members}}} | |
156 | ||
157 | \membersection{wxFileName::wxFileName}\label{wxfilenamewxfilename} | |
158 | ||
159 | \func{}{wxFileName}{\void} | |
160 | ||
161 | Default constructor. | |
162 | ||
163 | \func{}{wxFileName}{\param{const wxFileName\& }{filename}} | |
164 | ||
165 | Copy constructor. | |
166 | ||
167 | \func{}{wxFileName}{\param{const wxString\& }{fullpath}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
168 | ||
169 | From a full filename: if it terminates with a '/', a directory path | |
170 | is contructed (the name will be empty), otherwise a file name and | |
171 | extension are extracted from it | |
172 | ||
173 | \func{}{wxFileName}{\param{const wxString\& }{path}, \param{const wxString\& }{name}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
174 | ||
175 | Constructor from a directory name and a file name. | |
176 | ||
177 | \func{}{wxFileName}{\param{const wxString\& }{path}, \param{const wxString\& }{name}, \param{const wxString\& }{ext}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
178 | ||
179 | Constructor from a directory name, base file name and extension | |
180 | ||
181 | \func{}{wxFileName}{\param{const wxString\& }{volume}, \param{const wxString\& }{path}, \param{const wxString\& }{name}, \param{const wxString\& }{ext}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
182 | ||
183 | Constructor from a volume name, a directory name, base file name and extension | |
184 | ||
185 | \membersection{wxFileName::AppendDir}\label{wxfilenameappenddir} | |
186 | ||
187 | \func{void}{AppendDir}{\param{const wxString\& }{dir}} | |
188 | ||
189 | ||
190 | \membersection{wxFileName::Assign}\label{wxfilenameassign} | |
191 | ||
192 | \func{void}{Assign}{\param{const wxFileName\& }{filepath}} | |
193 | ||
194 | \func{void}{Assign}{\param{const wxString\& }{fullpath}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
195 | ||
196 | \func{void}{Assign}{\param{const wxString\& }{volume}, \param{const wxString\& }{path}, \param{const wxString\& }{name}, \param{const wxString\& }{ext}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
197 | ||
198 | \func{void}{Assign}{\param{const wxString\& }{path}, \param{const wxString\& }{name}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
199 | ||
200 | \func{void}{Assign}{\param{const wxString\& }{path}, \param{const wxString\& }{name}, \param{const wxString\& }{ext}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
201 | ||
202 | ||
203 | \membersection{wxFileName::AssignCwd}\label{wxfilenameassigncwd} | |
204 | ||
205 | \func{void}{AssignCwd}{\param{const wxString\& }{volume = ""}} | |
206 | ||
207 | Makes this object refer to the current working directory on the specified | |
208 | volume (or current volume if {\it volume} is empty). | |
209 | ||
210 | \wxheading{See also} | |
211 | ||
212 | \helpref{GetCwd}{wxfilenamegetcwd} | |
213 | ||
214 | \membersection{wxFileName::AssignDir}\label{wxfilenameassigndir} | |
215 | ||
216 | \func{void}{AssignDir}{\param{const wxString\& }{dir}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
217 | ||
218 | Set this file name object to the given directory name. The name and extension | |
219 | will be empty. | |
220 | ||
221 | \membersection{wxFileName::AssignHomeDir}\label{wxfilenameassignhomedir} | |
222 | ||
223 | \func{void}{AssignHomeDir}{\void} | |
224 | ||
225 | Set this file name object to the home directory. | |
226 | ||
227 | \membersection{wxFileName::AssignTempFileName}\label{wxfilenameassigntempfilename} | |
228 | ||
229 | \func{void}{AssignTempFileName}{\param{const wxString\& }{prefix}, \param{wxFile *}{fileTemp = {\tt NULL}}} | |
230 | ||
231 | The function calls \helpref{CreateTempFileName}{wxfilenamecreatetempfilename} to | |
232 | create a temporary file and sets this object to the name of the file. If a | |
233 | temporary file couldn't be created, the object is put into the\rtfsp | |
234 | \helpref{invalid}{wxfilenameisok} state. | |
235 | ||
236 | \membersection{wxFileName::Clear}\label{wxfilenameclear} | |
237 | ||
238 | \func{void}{Clear}{\void} | |
239 | ||
240 | Reset all components to default, uninitialized state. | |
241 | ||
242 | \membersection{wxFileName::CreateTempFileName}\label{wxfilenamecreatetempfilename} | |
243 | ||
244 | \func{static wxString}{CreateTempFileName}{\param{const wxString\& }{prefix}, \param{wxFile *}{fileTemp = {\tt NULL}}} | |
245 | ||
246 | Returns a temporary file name starting with the given {\it prefix}. If | |
247 | the {\it prefix} is an absolute path, the temporary file is created in this | |
248 | directory, otherwise it is created in the default system directory for the | |
249 | temporary files or in the current directory. | |
250 | ||
251 | If the function succeeds, the temporary file is actually created. If\rtfsp | |
252 | {\it fileTemp} is not {\tt NULL}, this file will be opened using the name of | |
253 | the temporary file. When possible, this is done in an atomic way ensuring that | |
254 | no race condition occurs between the temporary file name generation and opening | |
255 | it which could often lead to security compromise on the multiuser systems. | |
256 | If {\it fileTemp} is {\tt NULL}, the file is only created, but not opened. | |
257 | ||
258 | Under Unix, the temporary file will have read and write permissions for the | |
259 | owner only to minimize the security problems. | |
260 | ||
261 | \wxheading{Parameters} | |
262 | ||
263 | \docparam{prefix}{Prefix to use for the temporary file name construction} | |
264 | ||
265 | \docparam{fileTemp}{The file to open or {\tt NULL} to just get the name} | |
266 | ||
267 | \wxheading{Return value} | |
268 | ||
269 | The full temporary file name or an empty string on error. | |
270 | ||
271 | \membersection{wxFileName::DirExists}\label{wxfilenamedirexists} | |
272 | ||
273 | \func{bool}{DirExists}{\void} | |
274 | ||
275 | \func{bool}{DirExists}{\param{const wxString\& }{dir}} | |
276 | ||
277 | Does the directory with this name exists? | |
278 | ||
279 | \membersection{wxFileName::DirName}\label{wxfilenamedirname} | |
280 | ||
281 | \func{wxFileName}{DirName}{\param{const wxString\& }{dir}} | |
282 | ||
283 | \membersection{wxFileName::FileExists}\label{wxfilenamefileexists} | |
284 | ||
285 | \func{bool}{FileExists}{\void} | |
286 | ||
287 | \func{bool}{FileExists}{\param{const wxString\& }{file}} | |
288 | ||
289 | Does the file with this name exists? | |
290 | ||
291 | \membersection{wxFileName::FileName}\label{wxfilenamefilename} | |
292 | ||
293 | \func{wxFileName}{FileName}{\param{const wxString\& }{file}} | |
294 | ||
295 | static pseudo constructors | |
296 | ||
297 | \membersection{wxFileName::GetCwd}\label{wxfilenamegetcwd} | |
298 | ||
299 | \func{wxString}{GetCwd}{\param{const wxString\& }{volume = ""}} | |
300 | ||
301 | Retrieve the value of the current working directory on the specified volume. If | |
302 | the volume is empty, the programs current working directory is returned for the | |
303 | current volume. | |
304 | ||
305 | \wxheading{Return value} | |
306 | ||
307 | The string containing the current working directory or an empty string on | |
308 | error. | |
309 | ||
310 | \wxheading{See also} | |
311 | ||
312 | \helpref{AssignCwd}{wxfilenameassigncwd} | |
313 | ||
314 | \membersection{wxFileName::GetDirCount}\label{wxfilenamegetdircount} | |
315 | ||
316 | \constfunc{size\_t}{GetDirCount}{\void} | |
317 | ||
318 | ||
319 | \membersection{wxFileName::GetDirs}\label{wxfilenamegetdirs} | |
320 | ||
321 | \constfunc{const wxArrayString\&}{GetDirs}{\void} | |
322 | ||
323 | ||
324 | \membersection{wxFileName::GetExt}\label{wxfilenamegetext} | |
325 | ||
326 | \constfunc{wxString}{GetExt}{\void} | |
327 | ||
328 | ||
329 | \membersection{wxFileName::GetFormat}\label{wxfilenamegetformat} | |
330 | ||
331 | \func{wxPathFormat}{GetFormat}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
332 | ||
333 | various helpers | |
334 | get the canonical path format for this platform | |
335 | ||
336 | ||
337 | \membersection{wxFileName::GetFullName}\label{wxfilenamegetfullname} | |
338 | ||
339 | \constfunc{wxString}{GetFullName}{\void} | |
340 | ||
341 | ||
342 | \membersection{wxFileName::GetFullPath}\label{wxfilenamegetfullpath} | |
343 | ||
344 | \constfunc{wxString}{GetFullPath}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
345 | ||
346 | add separator Construct full path with name and ext | |
347 | ||
348 | ||
349 | \membersection{wxFileName::GetHomeDir}\label{wxfilenamegethomedir} | |
350 | ||
351 | \func{wxString}{GetHomeDir}{\void} | |
352 | ||
353 | ||
354 | \membersection{wxFileName::GetLongPath}\label{wxfilenamegetlongpath} | |
355 | ||
356 | \constfunc{wxString}{GetLongPath}{\void} | |
357 | ||
358 | Return the long form of the path (returns identity on non-Windows platforms) | |
359 | ||
360 | ||
361 | \membersection{wxFileName::GetModificationTime}\label{wxfilenamegetmodificationtime} | |
362 | ||
363 | \constfunc{wxDateTime}{GetModificationTime}{\void} | |
364 | ||
365 | convenience wrapper: get just the last mod time of the file | |
366 | ||
367 | ||
368 | \membersection{wxFileName::GetName}\label{wxfilenamegetname} | |
369 | ||
370 | \constfunc{wxString}{GetName}{\void} | |
371 | ||
372 | ||
373 | \membersection{wxFileName::GetPath}\label{wxfilenamegetpath} | |
374 | ||
375 | \constfunc{wxString}{GetPath}{\param{bool }{add\_separator = FALSE}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
376 | ||
377 | Construct path only - possibly with the trailing separator | |
378 | ||
379 | ||
380 | \membersection{wxFileName::GetPathSeparators}\label{wxfilenamegetpathseparators} | |
381 | ||
382 | \func{wxString}{GetPathSeparators}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
383 | ||
384 | get the string of path separators for this format | |
385 | ||
386 | ||
387 | \membersection{wxFileName::GetPathWithSep}\label{wxfilenamegetpathwithsep} | |
388 | ||
389 | \constfunc{wxString}{GetPathWithSep}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
390 | ||
391 | more readable synonym | |
392 | ||
393 | ||
394 | \membersection{wxFileName::GetShortPath}\label{wxfilenamegetshortpath} | |
395 | ||
396 | \constfunc{wxString}{GetShortPath}{\void} | |
397 | ||
398 | Return the short form of the path (returns identity on non-Windows platforms) | |
399 | ||
400 | ||
401 | \membersection{wxFileName::GetTimes}\label{wxfilenamegettimes} | |
402 | ||
403 | \constfunc{bool}{GetTimes}{\param{wxDateTime* }{dtAccess}, \param{wxDateTime* }{dtMod}, \param{wxDateTime* }{dtChange}} | |
404 | ||
405 | return the last access, last modification and last change times | |
406 | (any of the pointers may be NULL) | |
407 | ||
408 | ||
409 | \membersection{wxFileName::GetVolume}\label{wxfilenamegetvolume} | |
410 | ||
411 | \constfunc{wxString}{GetVolume}{\void} | |
412 | ||
413 | ||
414 | \membersection{wxFileName::GetVolumeSeparator}\label{wxfilenamegetvolumeseparator} | |
415 | ||
416 | \func{wxString}{GetVolumeSeparator}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
417 | ||
418 | get the string separating the volume from the path for this format | |
419 | ||
420 | ||
421 | \membersection{wxFileName::HasExt}\label{wxfilenamehasext} | |
422 | ||
423 | \constfunc{bool}{HasExt}{\void} | |
424 | ||
425 | ||
426 | \membersection{wxFileName::HasName}\label{wxfilenamehasname} | |
427 | ||
428 | \constfunc{bool}{HasName}{\void} | |
429 | ||
430 | ||
431 | \membersection{wxFileName::HasVolume}\label{wxfilenamehasvolume} | |
432 | ||
433 | \constfunc{bool}{HasVolume}{\void} | |
434 | ||
435 | ||
436 | \membersection{wxFileName::InsertDir}\label{wxfilenameinsertdir} | |
437 | ||
438 | \func{void}{InsertDir}{\param{int }{before}, \param{const wxString\& }{dir}} | |
439 | ||
440 | ||
441 | \membersection{wxFileName::IsAbsolute}\label{wxfilenameisabsolute} | |
442 | ||
443 | \func{bool}{IsAbsolute}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
444 | ||
445 | is this filename absolute? | |
446 | ||
447 | ||
448 | \membersection{wxFileName::IsCaseSensitive}\label{wxfilenameiscasesensitive} | |
449 | ||
450 | \func{bool}{IsCaseSensitive}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
451 | ||
452 | Tests | |
453 | are the file names of this type cases sensitive? | |
454 | ||
455 | ||
456 | \membersection{wxFileName::IsOk}\label{wxfilenameisok} | |
457 | ||
458 | \constfunc{bool}{IsOk}{\void} | |
459 | ||
460 | Returns {\tt TRUE} if the filename is valid, {\tt FALSE} if it is not | |
461 | initialized yet. The assignment functions and | |
462 | \helpref{Clear}{wxfilenameclear} may reset the object to the uninitialized, | |
463 | invalid state (the former only do it on failure). | |
464 | ||
465 | \membersection{wxFileName::IsPathSeparator}\label{wxfilenameispathseparator} | |
466 | ||
467 | \func{bool}{IsPathSeparator}{\param{wxChar }{ch}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
468 | ||
469 | Returns {\tt TRUE} if the char is a path separator for this format. | |
470 | ||
471 | \membersection{wxFileName::IsRelative}\label{wxfilenameisrelative} | |
472 | ||
473 | \func{bool}{IsRelative}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
474 | ||
475 | Returns {\tt TRUE} if this filename is not absolute. | |
476 | ||
477 | \membersection{wxFileName::IsWild}\label{wxfilenameiswild} | |
478 | ||
479 | \func{bool}{IsWild}{\param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
480 | ||
481 | FIXME: what exactly does this do? | |
482 | ||
483 | \membersection{wxFileName::MakeRelativeTo}\label{wxfilenamemakerelativeto} | |
484 | ||
485 | \func{bool}{MakeRelativeTo}{\param{const wxString\& }{pathBase = ""}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
486 | ||
487 | This function tries to put this file name in a form relative to {\it pathBase}. | |
488 | In other words, it returns the file name which should be used to access this | |
489 | file if the current directory were {\it pathBase}. | |
490 | ||
491 | \docparam{pathBase}{the directory to use as root, current directory is used by | |
492 | default} | |
493 | ||
494 | \docparam{format}{the file name format, native by default} | |
495 | ||
496 | \wxheading{Return value} | |
497 | ||
498 | {\tt TRUE} if the file name has been changed, {\tt FALSE} if we failed to do | |
499 | anything with it (currently this only happens if the file name is on a volume | |
500 | different from the volume specified by {\it pathBase}). | |
501 | ||
502 | \wxheading{See also} | |
503 | ||
504 | \helpref{Normalize}{wxfilenamenormalize} | |
505 | ||
506 | \membersection{wxFileName::Mkdir}\label{wxfilenamemkdir} | |
507 | ||
508 | \func{bool}{Mkdir}{\param{int }{perm = 0777}, \param{bool }{full = FALSE}} | |
509 | ||
510 | \func{static bool}{Mkdir}{\param{const wxString\& }{dir}, \param{int }{perm = 0777}, \param{bool }{full = FALSE}} | |
511 | ||
512 | \docparam{dir}{the directory to create} | |
513 | ||
514 | \docparam{parm}{the permissions for the newly created directory} | |
515 | ||
516 | \docparam{full}{if {\tt TRUE}, will try to make each directory in the path} | |
517 | ||
518 | \wxheading{Return value} | |
519 | ||
520 | Returns {\tt TRUE} if the directory was successfully created, {\tt FALSE} | |
521 | otherwise. | |
522 | ||
523 | \membersection{wxFileName::Normalize}\label{wxfilenamenormalize} | |
524 | ||
525 | \func{bool}{Normalize}{\param{wxPathNormalize }{flags = wxPATH\_NORM\_ALL}, \param{const wxString\& }{cwd = wxEmptyString}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
526 | ||
527 | operations on the path | |
528 | normalize the path: with the default flags value, the path will be | |
529 | made absolute, without any ".." and "." and all environment | |
530 | variables will be expanded in it | |
531 | this may be done using another (than current) value of cwd | |
532 | ||
533 | ||
534 | \membersection{wxFileName::PrependDir}\label{wxfilenameprependdir} | |
535 | ||
536 | \func{void}{PrependDir}{\param{const wxString\& }{dir}} | |
537 | ||
538 | ||
539 | \membersection{wxFileName::RemoveDir}\label{wxfilenameremovedir} | |
540 | ||
541 | \func{void}{RemoveDir}{\param{int }{pos}} | |
542 | ||
543 | ||
544 | \membersection{wxFileName::Rmdir}\label{wxfilenamermdir} | |
545 | ||
546 | \func{bool}{Rmdir}{\void} | |
547 | ||
548 | \func{static bool}{Rmdir}{\param{const wxString\& }{dir}} | |
549 | ||
550 | Deletes the specified directory. | |
551 | ||
552 | ||
553 | \membersection{wxFileName::SameAs}\label{wxfilenamesameas} | |
554 | ||
555 | \func{bool}{SameAs}{\param{const wxFileName\& }{filepath}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
556 | ||
557 | Compares the filename using the rules of this platform | |
558 | ||
559 | ||
560 | \membersection{wxFileName::SetCwd}\label{wxfilenamesetcwd} | |
561 | ||
562 | \func{bool}{SetCwd}{\void} | |
563 | ||
564 | \func{static bool}{SetCwd}{\param{const wxString\& }{cwd}} | |
565 | ||
566 | change the current working directory | |
567 | ||
568 | \membersection{wxFileName::SetExt}\label{wxfilenamesetext} | |
569 | ||
570 | \func{void}{SetExt}{\param{const wxString\& }{ext}} | |
571 | ||
572 | ||
573 | \membersection{wxFileName::SetFullName}\label{wxfilenamesetfullname} | |
574 | ||
575 | \func{void}{SetFullName}{\param{const wxString\& }{fullname}} | |
576 | ||
577 | full name is the file name + extension (but without the path) | |
578 | ||
579 | ||
580 | \membersection{wxFileName::SetName}\label{wxfilenamesetname} | |
581 | ||
582 | \func{void}{SetName}{\param{const wxString\& }{name}} | |
583 | ||
584 | ||
585 | \membersection{wxFileName::SetTimes}\label{wxfilenamesettimes} | |
586 | ||
587 | \func{bool}{SetTimes}{\param{const wxDateTime* }{dtCreate}, \param{const wxDateTime* }{dtAccess}, \param{const wxDateTime* }{dtMod}} | |
588 | ||
589 | set the file creation and last access/mod times | |
590 | (any of the pointers may be NULL) | |
591 | ||
592 | ||
593 | \membersection{wxFileName::SetVolume}\label{wxfilenamesetvolume} | |
594 | ||
595 | \func{void}{SetVolume}{\param{const wxString\& }{volume}} | |
596 | ||
597 | ||
598 | \membersection{wxFileName::SplitPath}\label{wxfilenamesplitpath} | |
599 | ||
600 | \func{void}{SplitPath}{\param{const wxString\& }{fullpath}, \param{wxString* }{volume}, \param{wxString* }{path}, \param{wxString* }{name}, \param{wxString* }{ext}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
601 | ||
602 | \func{void}{SplitPath}{\param{const wxString\& }{fullpath}, \param{wxString* }{path}, \param{wxString* }{name}, \param{wxString* }{ext}, \param{wxPathFormat }{format = wxPATH\_NATIVE}} | |
603 | ||
604 | split a fullpath into the volume, path, (base) name and extension | |
605 | (all of the pointers can be NULL) | |
606 | ||
607 | \membersection{wxFileName::Touch}\label{wxfilenametouch} | |
608 | ||
609 | \func{bool}{Touch}{\void} | |
610 | ||
611 | set the access and modification times to the current moment | |
612 | ||
613 | ||
614 | \membersection{wxFileName::operator=}\label{wxfilenameoperatorassign} | |
615 | ||
616 | \func{wxFileName\& operator}{operator=}{\param{const wxFileName\& }{filename}} | |
617 | ||
618 | \func{wxFileName\& operator}{operator=}{\param{const wxString\& }{filename}} | |
619 | ||
620 | Assigns the new value to this filename object. | |
621 | ||
622 | \membersection{wxFileName::operator==}\label{wxfilenameoperatorequal} | |
623 | ||
624 | \func{bool operator}{operator==}{\param{const wxFileName\& }{filename}} | |
625 | ||
626 | \func{bool operator}{operator==}{\param{const wxString\& }{filename}} | |
627 | ||
628 | Returns {\tt TRUE} if the filenames are equal for the native file format. | |
629 |