# py3.dict 库模块帮助文档

## py3 成员列表 <a id="py3" href="#py3">&#x23;</a>

### py3.dict <a id="py3.dict" href="#py3.dict">&#x23;</a>
创建新的字典对象  
此对象继承自 py3.object,  
一般不需要手动创建此对象,aardio 会在传参数时自动转换

### py3.dict() <a id="py3.dict" href="#py3.dict">&#x23;</a>
创建新字典

[返回对象:py3DictObject](#py3DictObject)

### py3.dict(aardio表) <a id="py3.dict" href="#py3.dict">&#x23;</a>
数为未指定元表的 aardio 表则转换为 Python 字典

### py3.dict(pyObject对象) <a id="py3.dict" href="#py3.dict">&#x23;</a>
如果传入 Python 对象是一个 dict,  
返回绑定相同对象的 py3.dict 对象,添加引用计数,对象销毁时负责释放引用计数  
否则将传入对象作为 Python 内置函数 dict 的参数并返回 py3.dict 对象  
失败返回 null

### py3.dict(pyObject指针) <a id="py3.dict" href="#py3.dict">&#x23;</a>
参数为指针则作为 Python 字典指针构建对象,  
不会添加引用计数,但对象销毁时负责释放引用计数

## py3DictObject 成员列表 <a id="py3DictObject" href="#py3DictObject">&#x23;</a>

### py3DictObject.* <a id="py3DictObject.any" href="#py3DictObject.any">&#x23;</a>
[返回对象:py3Object](https://www.aardio.com/zh-cn/docs/library-reference/py3/object.html#py3Object)

### py3DictObject.checkDict() <a id="py3DictObject.checkDict" href="#py3DictObject.checkDict">&#x23;</a>
检测是否字典

### py3DictObject.each() <a id="py3DictObject.each" href="#py3DictObject.each">&#x23;</a>

```aardio
for( kObject,vObject in py3DictObject.each() ){  
	/*两个都是py.object对象*/  
}  

[返回对象:py3Object](https://www.aardio.com/zh-cn/docs/library-reference/py3/object.html#py3Object)
```

### py3DictObject.eval("Python表达式",locals) <a id="py3DictObject.eval" href="#py3DictObject.eval">&#x23;</a>
以该字典为命名空间运行代码并返回值,省略参数 @locals 则默认设为当前字典  
类似 Python 代码中的 execfile("test.py", globals, locals)

### py3DictObject.eval() <a id="py3DictObject.eval" href="#py3DictObject.eval">&#x23;</a>
[返回对象:py3Object](https://www.aardio.com/zh-cn/docs/library-reference/py3/object.html#py3Object)

### py3DictObject.exec("Python代码",locals) <a id="py3DictObject.exec" href="#py3DictObject.exec">&#x23;</a>
以该字典为命名空间运行代码,省略参数 @locals 省略则默认设为当前字典  
类似 Python 代码中的 exec "..." in globals, locals 语句

### py3DictObject.getAttr("字符串参数") <a id="py3DictObject.getAttr" href="#py3DictObject.getAttr">&#x23;</a>
读属性值，也可以用成员操作符获取。  
除数值、布尔值、字符串、字节数组以外的值在 aardio 中存为 py.object 对象

### py3DictObject.getAttr() <a id="py3DictObject.getAttr" href="#py3DictObject.getAttr">&#x23;</a>
[返回对象:py3Object](https://www.aardio.com/zh-cn/docs/library-reference/py3/object.html#py3Object)

### py3DictObject.getItem("键名") <a id="py3DictObject.getItem" href="#py3DictObject.getItem">&#x23;</a>
返回指定索引的项，也可以用索引下标操作符 [] 取值。  
除数值、布尔值、字符串、字节数组以外的值在 aardio 中存为 py.object 对象

### py3DictObject.getItem() <a id="py3DictObject.getItem" href="#py3DictObject.getItem">&#x23;</a>
[返回对象:py3Object](https://www.aardio.com/zh-cn/docs/library-reference/py3/object.html#py3Object)

### py3DictObject.has("字符串参数") <a id="py3DictObject.has" href="#py3DictObject.has">&#x23;</a>
是否存在指定的属性

### py3DictObject.parseValue() <a id="py3DictObject.parseValue" href="#py3DictObject.parseValue">&#x23;</a>
转换为 aardio 表对象

### py3DictObject.setAttr("字符串参数",) <a id="py3DictObject.setAttr" href="#py3DictObject.setAttr">&#x23;</a>
写属性成员的值，也可以用成员操作符赋值。

### py3DictObject.setItem("键名",) <a id="py3DictObject.setItem" href="#py3DictObject.setItem">&#x23;</a>
修改指定索引的项，也可以用索引下标操作符 [] 赋值。

### py3DictObject.statement("Python语句",locals) <a id="py3DictObject.statement" href="#py3DictObject.statement">&#x23;</a>
以该字典为命名空间运行单个 Python 语句

### py3DictObject.stealPtr() <a id="py3DictObject.stealPtr" href="#py3DictObject.stealPtr">&#x23;</a>
接管此对象的指针并盗用一次引用计数  
原对象的内部指针被清空,并不再负责释放引用计数  
 steal references

### py3DictObject.toList() <a id="py3DictObject.toList" href="#py3DictObject.toList">&#x23;</a>
转换为 Python 列表  

[返回对象:py3ListObject](#py3ListObject)

### py3DictObject.toString() <a id="py3DictObject.toString" href="#py3DictObject.toString">&#x23;</a>
转换为 aardio 字符串  
也可以直接将对象作为参数传入 tostring 函数转换为字符串

### py3DictObject.toTuple() <a id="py3DictObject.toTuple" href="#py3DictObject.toTuple">&#x23;</a>
转换为 Python 元组  

[返回对象:py3TupleObject](#py3TupleObject)

### py3DictObject.type() <a id="py3DictObject.type" href="#py3DictObject.type">&#x23;</a>
返回类型名字
