37.1. ic — 访问 Mac OS X Internet 配置 — Python 文档

37.1. 我知道了 — 访问 Mac OS X Internet 配置

此模块提供对通过 系统偏好设置 或 查找器 设置的各种互联网相关偏好设置的访问。

笔记

此模块已在 Python 3.x 中删除。

有一个低级配套模块 icglue，它提供基本的 Internet 配置访问功能。 这个低级模块没有文档化，但例程的文档字符串记录了参数，例程名称与 Pascal 或 C API to Internet Config 相同，因此如果此模块是标准的 IC 程序员文档，则可以使用需要。

ic 模块定义了 error 异常和 Internet Config 可以产生的所有错误代码的符号名称； 有关详细信息，请参阅来源。

exception ic.error

ic 模块中的错误引发异常。

ic 模块定义了以下类和函数：

class ic.IC([signature[, ic]])

创建一个 Internet 配置对象。 签名是当前应用程序的 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['MailAddress']。 分配也有效，并更改配置文件中的选项。

该模块了解各种数据类型，并将内部 IC 表示转换为“逻辑”Python 数据结构。 独立运行 ic 模块将运行一个测试程序，列出 IC 数据库中的所有键和值，这必须作为文档。

如果模块不知道如何表示数据，它将返回 ICOpaqueData 类型的实例，原始数据在其 data 属性中。 这种类型的对象也是可接受的赋值值。

除了字典接口，IC对象还有以下方法：

IC.launchurl(url[, hint])

解析给定的 URL，启动正确的应用程序并将 URL 传递给它。 可选的 hint 可以是方案名称，例如 'mailto:'，在这种情况下，不完整的 URL 使用此方案完成。 如果未提供 hint，则不完整的 URL 无效。

IC.parseurl(data[, start[, end[, hint]]])

在 data 的某处找到一个 URL 并返回开始位置、结束位置和 URL。 可选的 start 和 end 可用于限制搜索，例如，如果用户单击一个长文本字段，您可以传递整个文本字段和单击位置start 并且此例程将返回用户单击的整个 URL。 如上所述，hint 是一个可选方案，用于完成不完整的 URL。

IC.mapfile(file)

返回给定 file 的映射条目，它可以作为文件名或 FSSpec() 结果传递，并且不需要存在。

映射条目作为元组返回 (version, type, creator, postcreator, flags, extension, appname, postappname, mimetype, entryname)，其中 version 是条目版本号，type 是 4 个字符的文件类型，creator是4个字符的创建者类型，postcreator是一个可选应用程序的4个字符的创建者代码，用于下载后对文件进行后处理，flags是指定是否传入的各种位binary 或 ascii 等，extension 是该文件类型的文件扩展名，appname 是该文件所属的应用程序的可打印名称，postappname 是后处理应用程序的名称，mimetype 是该文件的 MIME 类型，entryname 是该条目的名称。

IC.maptypecreator(type, creator[, filename])

返回具有给定 4 字符 type 和 creator 代码的文件的映射条目。 可以指定可选的 filename 以进一步帮助找到正确的条目（例如，如果创建者代码是 '????'）。

映射条目以与 mapfile 相同的格式返回。

IC.settypecreator(file)

给定现有的 文件 ，指定为文件名或 FSSpec() 结果，根据其扩展名正确设置其创建者和类型。 finder 会被告知更改，因此 finder 图标将快速更新。