在线文档教程

plistlib

plistlib - 生成并解析Mac OS X .plist文件

在版本2.6中更改:此模块以前仅在Mac特定的库中可用,现在可用于所有平台。

源代码: Lib / plistlib.py

该模块提供了一个接口,用于读取和写入主要由Mac OS X使用的“属性列表”XML文件。

属性列表(.plist)文件格式是一个简单的XML pickle,支持基本对象类型,如字典,列表,数字和字符串。通常顶级对象是一个字典。

值可以是字符串,整数,浮点数,布尔值,元组,列表,字典(但仅限字符串键)Datadatetime.datetime对象。字符串值(包括字典键)可能是unicode字符串 - 它们将被写为UTF-8。

<data>的plist类型是通过支持Data类。这是一个Python字符串的薄包装。使用Data,如果你的字符串包含控制字符。

另请参阅

PList手册页苹果公司的文件格式文件。

该模块定义了以下功能:

plistlib.readPlist(pathOrFile)

阅读plist文件。pathOrFile可能是文件名或(可读)文件对象。返回解压后的根对象(通常是一个字典)。

XML数据使用Expat解析器进行分析xml.parsers.expat- 请参阅其文档以了解格式不正确的XML可能出现的异常。未知元素将被plist解析器忽略。

plistlib.writePlist(rootObject, pathOrFile)

rootObject写入plist文件。pathOrFile可以是文件名或(可写)文件对象。

如果对象是不受支持的类型或包含不受支持类型的对象的容器,则会引发TypeError

plistlib.readPlistFromString(data)

从字符串中读取plist。返回根对象。

plistlib.writePlistToString(rootObject)

rootObject作为plist格式的字符串返回。

plistlib.readPlistFromResource(path, restype='plst', resid=0)

路径的资源分支中从类型为restype的资源中读取plist 。可用性:Mac OS X.

注意

在Python 3.x中,该函数已被删除。

plistlib.writePlistToResource(rootObject, path, restype='plst', resid=0)

rootObject作为类型为restype的资源写入路径的资源分支。可用性:Mac OS X.

注意

在Python 3.x中,该函数已被删除。

以下课程可供选择:

class plistlib.Data(data)

围绕字符串数据返回一个“数据”包装器对象。这用于从plists转换成plists的函数来表示plists中<data>可用的类型。

它有一个属性,data可用于检索存储在其中的Python字符串。

1.例子

生成一个plist:

pl = dict( aString="Doodah", aList=["A", "B", 12, 32.1, [1, 2, 3]], aFloat = 0.1, anInt = 728, aDict=dict( anotherString="<hello & hi there!>", aUnicodeValue=u'M\xe4ssig, Ma\xdf', aTrueValue=True, aFalseValue=False, ), someData = Data("<binary gunk>"), someMoreData = Data("<lots of binary gunk>" * 10), aDate = datetime.datetime.fromtimestamp(time.mktime(time.gmtime())), ) # unicode keys are possible, but a little awkward to use: pl[u'\xc5benraa'] = "That was a unicode key." writePlist(pl, fileName)

解析plist:

pl = readPlist(pathOrFile) print pl["aKey"]