summaryrefslogtreecommitdiffstats
path: root/Doc/mac/libmac.tex
blob: b0a3382377568f9a147276d6b9bf841763599e8f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
\section{\module{mac} ---
         Implementations for the \module{os} module}

\declaremodule{builtin}{mac}
  \platform{Mac}
\modulesynopsis{Implementations for the \module{os} module.}


This module implements the operating system dependent functionality
provided by the standard module \module{os}\refstmodindex{os}.  It is
best accessed through the \module{os} module.

The following functions are available in this module:
\function{chdir()},
\function{close()},
\function{dup()},
\function{fdopen()},
\function{getcwd()},
\function{lseek()},
\function{listdir()},
\function{mkdir()},
\function{open()},
\function{read()},
\function{rename()},
\function{rmdir()},
\function{stat()},
\function{sync()},
\function{unlink()},
\function{write()},
as well as the exception \exception{error}. Note that the times
returned by \function{stat()} are floating-point values, like all time
values in MacPython.

One additional function is available, but only under Classic MacPython,
not under Carbon MacPython:

\begin{funcdesc}{xstat}{path}
  This function returns the same information as \function{stat()}, but
  with three additional values appended: the size of the resource fork
  of the file and its 4-character creator and type.
  Availability: Classic MacPython only.
  \deprecated{2.3}{Use the \function{\refmodule{macfs}.FSSpec()}
                   function to get an FSSpec object for the file, then
                   use the \method{GetCreatorType()} method to get the
                   creator and type information.  It will no longer be
                   possible to get the size of the resource fork.}
\end{funcdesc}


\section{\module{macpath} ---
         MacOS path manipulation functions}

\declaremodule{standard}{macpath}
% Could be labeled \platform{Mac}, but the module should work anywhere and
% is distributed with the standard library.
\modulesynopsis{MacOS path manipulation functions.}


This module is the Macintosh implementation of the \module{os.path}
module.  It is most portably accessed as
\module{os.path}\refstmodindex{os.path}.  Refer to the
\citetitle[../lib/lib.html]{Python Library Reference} for
documentation of \module{os.path}.

The following functions are available in this module:
\function{normcase()},
\function{normpath()},
\function{isabs()},
\function{join()},
\function{split()},
\function{isdir()},
\function{isfile()},
\function{walk()},
\function{exists()}.
For other functions available in \module{os.path} dummy counterparts
are available.