2.4.1 ICオブジェクト

ICオブジェクトは対応付けのインターフェースを持っているので、メールアドレスは単にic['MailAddress']で得ることができます。値の代入も機能しますし、設定ファイルのオプションを変えることができます。

このモジュールは各種のデータ型を知っているので、IC内部の表現を``論理的'' なPythonデータ構造に変換します。icモジュールをスタンドアロンで実行するとテストプログラムが実行され、ICデータベースにある全てのキーと値のペアをリスト表示するので、文書代わりになります。

もしこのモジュールがデータをどう表わすか分からない場合は、data 属性に生のデータを入れたICOpaqueDataタイプのインスタンスを返します。このタイプのオブジェクトは値のアクセスだけでなく代入も可能です。

ディクショナリのインターフェースだけでなく、ICには以下のメソッドがあります。

launchurl( url[, hint]): 与えられたURLを解析し、正しいアプリケーションを起動してURLを渡します。省略可能なhintは、'mailto:'などのスキーム名で、不完全なURLはこのスキームにあわせて完全化されます。もしhintが与えられていない場合は、不完全なURLは無効になります。

parseurl( data[, start[, end[, hint]]]): dataの中からURLを検索して、URLの開始位置、終了位置、URLそのものを返します。省略可能なstartとendで検索範囲を制限することができます。例えば、ユーザーが長いテキストフィールドをクリックしたとしても、テキストフィールド全体とクリック位置startを渡すことができて、このルーチンによってユーザーがクリックしたテキストからURL全体が返されます。既に述べたように、hintはオプションのスキームで、不完全なURLを完全化するために使われます。

mapfile( file): 与えられたfileに対するマッピングエントリーを返します。fileとしてファイル名かmacfs.FSSpec()の結果を渡すことができて、存在しないファイルであってもかまいません。
マッピングエントリーはタプル(version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname) として返されます。ここでversionはエントリーのバージョン番号、 typeは4文字のファイルタイプ、creatorは4文字のクリエータタイプ、postcreatorは省略可能な後処理用アプリケーションを示す4文字のクリエータで、このアプリケーションはファイルをダウンロードした後にファイルを後処理します。flagsは各種のビットであり、転送をバイナリで行うかアスキーで行うかなどを表わします。extensionはこのファイルタイプに対するファイル名の拡張子、appnameはファイルが属するアプリケーションの出力可能な名前、postappnameは後処理用アプリケーション、mimetypeはこのファイルのMIMEタイプ、最後のentrynameはこのエントリーの名前です。

maptypecreator( type, creator[, filename]): 与えられた4文字のtypeとcreatorを持つファイルに対するマッピングエントリーを返します。正しいエントリーが見つかりやすいように、オプションのfilenameを指定することもできます(例えばクリエータ'????' の場合など)。
マッピングエントリーはmapfileと同じフォーマットで返されます。

settypecreator( file): 存在するfileをファイル名かmacfs.FSSpec()の結果として与えると、拡張子から判断してクリエータとタイプを適切にセットします。ファインダにこの変更が伝えられるので、ファインダのアイコンは即座に更新されます。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。