37.1。 IC — Mac OSXインターネット構成へのアクセス
このモジュールは、システム環境設定またはファインダーを介して設定されたさまざまなインターネット関連の環境設定へのアクセスを提供します。
ノート
このモジュールはPython3.xで削除されました。
基本的なインターネット構成アクセス機能を提供する低レベルのコンパニオンモジュールicglue
があります。 この低レベルモジュールは文書化されていませんが、ルーチンのdocstringはパラメーターを文書化し、ルーチン名はPascalまたはC API to Internet Configの場合と同じであるため、このモジュールが必要です。
ic モジュールは、InternetConfigが生成できるすべてのエラーコードの error 例外と記号名を定義します。 詳細については、ソースを参照してください。
- exception ic.error
- ic モジュールのエラーで例外が発生しました。
ic モジュールは、次のクラスと関数を定義します。
- class ic.IC([signature[, ic]])
- InternetConfigオブジェクトを作成します。 署名は、現在のアプリケーションの4文字の作成者コード(デフォルトは
'Pyth'
)であり、一部のIC設定に影響を与える可能性があります。 オプションの ic 引数は、事前に作成された低レベルのicglue.icinstance
です。これは、別の構成ファイルなどから設定を取得する場合に役立ちます。
- ic.launchurl(url[, hint])
ic.parseurl(data[, start[, end[, hint]]])
ic.mapfile(file)
ic.maptypecreator(type, creator[, filename])
ic.settypecreator(file)
- これらの関数は、以下で説明する同じ名前のメソッドへの「ショートカット」です。
37.1.1。 ICオブジェクト
IC オブジェクトにはマッピングインターフェイスがあるため、メールアドレスを取得するには、ic['MailAddress']
を取得するだけです。 割り当ても機能し、構成ファイルのオプションを変更します。
このモジュールはさまざまなデータ型を認識しており、内部IC表現を「論理的な」Pythonデータ構造に変換します。 ic モジュールをスタンドアロンで実行すると、ICデータベース内のすべてのキーと値を一覧表示するテストプログラムが実行されます。これはドキュメントとして機能する必要があります。
モジュールがデータの表現方法を知らない場合は、data
属性に生データを含むICOpaqueData
タイプのインスタンスを返します。 このタイプのオブジェクトも、割り当てに使用できる値です。
ディクショナリインターフェイスの他に、 IC オブジェクトには次のメソッドがあります。
- IC.launchurl(url[, hint])
- 指定されたURLを解析し、正しいアプリケーションを起動して、URLを渡します。 オプションのヒントは、
'mailto:'
などのスキーム名にすることができます。この場合、不完全なURLはこのスキームで補完されます。 ヒントが指定されていない場合、不完全なURLは無効です。
- IC.parseurl(data[, start[, end[, hint]]])
- data のどこかでURLを見つけて、開始位置、終了位置、およびURLを返します。 オプションの start および end を使用して検索を制限できるため、たとえば、ユーザーが長いテキストフィールドをクリックした場合、テキストフィールド全体とクリック位置を start とこのルーチンは、ユーザーがクリックしたURL全体を返します。 上記のように、ヒントは、不完全なURLを完成させるために使用されるオプションのスキームです。
- IC.mapfile(file)
指定されたファイルのマッピングエントリを返します。これは、ファイル名または
FSSpec()
の結果として渡すことができ、存在する必要はありません。マッピングエントリはタプル
(version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname)
として返されます。ここで、 version はエントリのバージョン番号、 type は4文字のファイルタイプ、 creator です。は4文字のクリエータータイプ、 postcreator はダウンロード後にファイルを後処理するオプションアプリケーションの4文字のクリエーターコード、フラグは転送するかどうかを指定するさまざまなビットですバイナリまたはASCIIなど、 extension はこのファイルタイプのファイル名拡張子、 appname はこのファイルが属するアプリケーションの印刷可能な名前、 postappname は後処理アプリケーションの名前。 mimetype はこのファイルのMIMEタイプであり、 entryname はこのエントリの名前です。
- IC.maptypecreator(type, creator[, filename])
指定された4文字のタイプおよび作成者コードを持つファイルのマッピングエントリを返します。 オプションのファイル名を指定すると、正しいエントリを見つけるのにさらに役立ちます(たとえば、作成者コードが
'????'
の場合)。マッピングエントリは、 mapfile の場合と同じ形式で返されます。
- IC.settypecreator(file)
- ファイル名または
FSSpec()
の結果として指定された、既存のファイルが与えられた場合、その作成者を設定し、拡張子に基づいて正しく入力します。 ファインダーに変更が通知されるため、ファインダーアイコンがすばやく更新されます。