This document is for an old version of Python that is no longer supported. You should upgrade and read the Python documentation for the current stable release.

# 37.2. `MacOS` --- Mac OS インタプリタ機能へのアクセス

このモジュールは、Python インタプリタ内の MacOS 固有の機能に対するアクセスを提供します。例えば、インタプリタのイベントループ関数などです。十分注意して利用してください。

注釈

このモジュールは Python 3.x で削除されました。

モジュール名が大文字で始まることに注意してください。これは昔からの約束です。

`MacOS.``runtimemodel`

  Python 2.4 以降は常に `'macho'` です。それより前のバージョンの Python では、古い Mac OS 8 ランタイムモデルの場合は `'ppc'` 、 Mac OS 9 ランタイムモデルの場合は `'carbon'` となります。

`MacOS.``linkmodel`

  インタープリタがどのような方法でリンクされているかを返します。拡張モジュールがリンクモデル間で非互換性かもしれない場合、パッケージはより多くの適切なエラーメッセージを伝えるためにこの情報を使用することができます。値は静的リンクした Python は `'static'` 、Mac OS X framework で構築した Python は `'framework'` 、標準の Unix 共有ライブラリ (shared library) で構築された Python は `'shared'` となります。古いバージョンの Python の場合、Mac OS 9 互換の Python では `'cfm'` となります。

exception `MacOS.``Error`

  MacOS でエラーがあると、このモジュールの関数か、Mac 固有なツールボックスインターフェースモジュールから、この例外が生成されます。引数は、整数エラーコード (`OSErr` 値) とテキストで記述されたエラーコードです。分かっている全てのエラーコードのシンボル名は、標準モジュール `macerrors` で定義されています。

`MacOS.``GetErrorString`(errno)

  MacOS のエラーコード errno のテキスト表現を返します。

`MacOS.``DebugStr`(message[, object])

  Mac OS X 上では、文字列を単純に標準エラー出力に送るだけです (古いバージョンの Mac OSでは、より複雑な機能が使用できました)。しかし、低水準のデバッガ (gdb など) 用にブレークポイントを設定する場所も適切に用意しています。

  注釈

  64 ビットモードでは使用できません。

`MacOS.``SysBeep`()

  ベルを鳴らします。

  注釈

  64 ビットモードでは使用できません。

`MacOS.``GetTicks`()

  システム起動時からのティック数 (clock ticks、1/60秒) を得ます。

`MacOS.``GetCreatorAndType`(file)

  2 つの 4 文字の文字列としてファイルクリエータおよびファイルタイプを返します。 file 引数はパスもしくは、 `FSSpec` 、 `FSRef` オブジェクトを与える事ができます。

  注釈

  `FSSpec` は 64 ビットモードでは使うことができません。

`MacOS.``SetCreatorAndType`(file, creator, type)

  ファイルクリエータおよびファイルタイプを設定します。 file 引数はパスもしくは、 `FSSpec` 、 `FSRef` オブジェクトを与える事ができます。 creator と type は 4 文字の文字列が必要です。

  注釈

  `FSSpec` は 64 ビットモードでは使うことができません。

`MacOS.``openrf`(name[, mode])

  ファイルのリソースフォークを開きます。引数は組み込み関数 `open()` と同じです。返されたオブジェクトはファイルのように見えるかもしれませんが、これは Python のファイルオブジェクトではありませんので扱いに微妙な違いがあります。

`MacOS.``WMAvailable`()

  現在のプロセスがウィンドウマネージャへのアクセスを持っているかどうかをチェックします。メソッドはウィンドウマネージャが存在しない場合は `False` を返します。これは例えば Mac OS X サーバー上で動作している、あるいは SSH でログインしている、もしくは現在のインタープリタがフルブローンアプリケーションバンドル (fullblown application bundle) から起動されていないなどの場合に起こります。スクリプトは python ではなく pythonw で開始する際か、アプレットとして実行する際のどちらかの場合に、アプリケーションバンドルから起動します。

`MacOS.``splash`([resourceid])

  リソース id でスプラッシュスクリーンを開きます。スプラッシュスクリーンを閉じるには resourceid `0` を使います。

  注釈

  64 ビットモードでは使用できません。