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 图标将快速更新。