libmac.tex 2.44 KB
Newer Older
Fred Drake's avatar
Fred Drake committed
1
\section{\module{mac} ---
2
         Implementations for the \module{os} module}
3

4 5
\declaremodule{builtin}{mac}
  \platform{Mac}
6
\modulesynopsis{Implementations for the \module{os} module.}
7

8

9 10 11
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.
12 13

The following functions are available in this module:
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
\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.
33

34 35
One additional function is available, but only under Classic MacPython,
not under Carbon MacPython:
36 37 38 39 40

\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.
41 42 43 44 45 46
  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.}
47
\end{funcdesc}
48

49

Fred Drake's avatar
Fred Drake committed
50
\section{\module{macpath} ---
51
         MacOS path manipulation functions}
52

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

58

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

The following functions are available in this module:
66 67 68 69 70 71 72 73 74
\function{normcase()},
\function{normpath()},
\function{isabs()},
\function{join()},
\function{split()},
\function{isdir()},
\function{isfile()},
\function{walk()},
\function{exists()}.
75
For other functions available in \module{os.path} dummy counterparts
76
are available.