aardio 文档

py3.object 库模块帮助文档

py3 成员列表

py3.object

所有Python对象都是一个pyObject
在aardio中使用py3.object封装该指针为对象,
并自动管理引用计数

py3.object()

返回对象:py3Object

py3.object(aardio值)

将aardio值转换为pyObject
py3扩展库负责在与python交互时自动转换能转换的基础数据类型
其他对象aardio代码接触到的都会是py3.object
原始pyObject指针原则上保证不会返回给aardio调用代码

py3.object(pyObject封装对象)

参数是py3.object封装对象
复制一个对象,并增加引用计数
并负责在封装对象销毁时释放一次pyObject引用计数

这里传入的参数是aardio值,或者是py3.object统一都会返回py3.object
py3扩展库基于这种兼容性自动转换所有aardio,python对象

py3.object(pyObject指针,true)

参数@2为true,参数@1就必须是pyObject对象指针
返回pyObject封装对象,并负责在封装对象销毁时释放一次pyObject引用计数,
原始pyObject指针原则上保证不会返回给aardio调用代码
这种用法仅用于py扩展库内部使用

py3Object 成员列表

py3Object.?

输入 Python 对象属性或函数名称。
如果首字符为 $ ,则返回支持命名参数的函数对象。
也就是说 pyObject.$fun 等价于 pyObject.fun.invoke。

返回对象:py3Object

py3Object.call()

返回对象:py3Object

py3Object.call(不定个数参数)

该对象为 Python 函数对象时支持使用此方法调用 Python 函数,
也可以不写 call 函数,直接作为普通函数调用。
参数为不定个数的字符串、数值、布尔值等。

如果函数调用成功,
返回值除数值、布尔值、字符串、字节数组以外的值
在 aardio 中存为 py.object 对象

py3Object.callObject( py3.tuple对象 )

该对象为 Python 函数对象时支持使用此方法调用 Python 函数,
参数为tuple元数组对象
返回值为 py3.object对象,可使用 tostring 或 tonumber 等函数转换为aardio类型

py3Object.callObject()

返回对象:py3Object

py3Object.checkBool()

检测是否布尔值

py3Object.checkBytes()

检测是否字节串

py3Object.checkDict()

检测是否字典

py3Object.checkFloat()

检测是否浮点数

py3Object.checkList()

检测是否列表

py3Object.checkLong()

检测是否整数

py3Object.checkNumber()

检测是否数值

py3Object.checkTuple()

检测是否字典

py3Object.checkUnicode()

检测是否字符串,注意Py3中字符串都是Unicode,取回aardio都是UTF8编码

py3Object.each()

for( pyItem in py3Object.each() ){  
    /*创建迭代器用于遍历所有的项,返回一个值*/  
}  

[返回对象:py3Object](https://www.aardio.com/zh-cn/doc/library-reference/py3/object.html#py3Object)

py3Object.getAttr("字符串参数")

读属性值,也可以用成员操作符获取。
除数值、布尔值、字符串、字节数组以外的值在 aardio 中存为 py.object 对象。
指定可选参数 @2 为 true 则不检查属性是否存在。

py3Object.getAttr()

返回对象:py3Object

py3Object.getFuncDesc

function(){
    return PyEval_GetFuncDesc(owner.pyObject ); 
}

py3Object.getFuncDesc()

获取函数原型,返回值为字符串。

py3Object.getFuncName()

获取函数名,返回值为字符串。

py3Object.getFuncName()

获取函数名

py3Object.getItem(索引)

返回指定索引的项,也可以用索引下标操作符 [] 取值。
除数值、布尔值、字符串、字节数组以外的值在 aardio 中存为 py.object 对象

py3Object.getTypeFlags()

返回类型特性,用法请参考此函数源码以及 Python 文档

py3Object.has("字符串参数")

是否存在指定的属性

py3Object.hasFeature()

检测类型特性,这个函数实现了C++中的PyType_HasFeature宏相同的功能

py3Object.invoke

该对象为 Python 函数对象时支持使用此方法调用 Python 函数,
与通过 call 方法调用不同的是 invoke 支持传递命名参数,
如果函数调用成功,返回值除数值、布尔值、字符串、字节数组以外的值
在 aardio 中存为 py.object 对象。

pyObject.func.invoke 可缩写为 pyObject.$func

py3Object.invoke()

返回对象:py3Object

py3Object.invoke(kwarg=value,arg1...)

如果参数@1是未指定元表的纯表对象,且没有 pyObject 成员,
则将该表中的名值对作为调用时的命名参数,
该表中的数组成员作为调用时的匿名参数,
注意名值对参数应当且只能写在最前面,所有参数请用逗号分隔。

如果指定了第 2 个参数或更多参数,则 kwarg 的数组成员被忽略。
如果参数 @1 不符合前述规则,
则与 call 调用相同的方式将所有参数作为调用时的匿名参数。

如果参数 @1 为 null,则忽略第一个参数并禁用命名参数。
并将第二个参数作为第一个参数,后续参数依次前移。

py3Object.invokeObject

该对象为 Python 函数对象时支持使用此方法调用 Python 函数,
与通过 call 方法调用不同的是 invokeObject 支持传递命名参数,
调用成功返回值为 py3.object 对象。
invoke 函数调用 invokeObject 函数并会转换基础类型的值为纯 aardio 值。

py3Object.invokeObject()

返回对象:py3Object

返回对象:py3Object

py3Object.invokeObject(kwarg=value,arg1...)

如果参数@1是未指定元表的纯表对象,且没有 pyObject 成员,
则将该表中的名值对作为调用时的命名参数,
该表中的数组成员作为调用时的匿名参数,
注意名值对参数应当且只能写在最前面,所有参数请用逗号分隔。

如果指定了第 2 个参数或更多参数,则 kwarg 的数组成员被忽略。
如果参数 @1 不符合前述规则,
则与 call 调用相同的方式将所有参数作为调用时的匿名参数。

如果参数 @1 为 null,则忽略第一个参数并禁用命名参数。
并将第二个参数作为第一个参数,后续参数依次前移。

py3Object.parseValue()

检测 Python 对象的类型,并自动返回对应的aardio类型对象。
基础的数值字符串布尔值转换为同类型,整数值即使大于 53 位仍转为浮点数。
dict, list, tuple 等等使用json格式转换为 aardio 类型的表

py3Object.parseValue(true)

检测P ython 对象的类型,
基础类型返回对应的 aardio 类型对象,其他对象返回自身。
基础类型指:数值、布尔值、字符串、字节数组。
数值仅转换浮点数值,以及不大于 53位(bit)的整数值。
字节数组指 Python 中的 bytes,aardio 中的 buffer 对象。
所有 Python 返回的对象自动调用此函数转换基础类型。

py3Object.setAttr("字符串参数",)

写属性成员的值,也可以用成员操作符赋值。

py3Object.setItem(索引,)

修改指定索引的项,也可以用索引下标操作符 [] 赋值。

py3Object.size64()

获取64位无符号长整数
返回 math.size64 对象

py3Object.stealPtr()

接管此对象的指针并盗用一次引用计数
原对象的内部指针被清空,并不再负责释放引用计数
steal references

py3Object.toBool()

解析为 aardio 布尔值

py3Object.toBytes()

解析为 aardio 字节数组

py3Object.toDict()

如果 Python 对象是一个 dict,
返回绑定相同 Python 对象的 py3.dict 对象,
添加引用计数,对象销毁时负责释放引用计数,
否则将传入对象作为 Python 内置函数 dict 的参数并返回 py3.dict 对象,
失败返回null

返回对象:py3DictObject

py3Object.toList()

如果 Python 对象是一个 list,
返回绑定相同 Python 对象的 py3.list 对象,
添加引用计数,对象销毁时负责释放引用计数,
否则将传入对象作为 Python 内置函数 list 的参数并返回 py3.list 对象,
失败返回null

返回对象:py3ListObject

py3Object.toNumber()

解析为 aardio 数值
也可以直接将对象传入 tonumber 函数并转换为数值

py3Object.toStr()

Python 对象转换为 Python 字符串对象,
相当于调用 Python 中的 str 函数,
如果要返回 aardio 字符串可使用 toString 函数,
也可以调用 py3.str 函数创建 Python 字符串对象

py3Object.toString()

Python 对象转换为 aardio 字符串
Python 字节数组(bytes)解析为aardio中的字节数组(buffer)
其他类型尝试调用 Python 中的 str 函数转换为 aardio 字符串,
也可以直接将对象作为参数传入 tostring 函数转换为字符串

py3Object.toTuple()

如果 Python 对象是一个 tuple,
返回绑定相同 Python 对象的 py3.tuple 对象,
添加引用计数,对象销毁时负责释放引用计数,
否则将传入对象作为 Python 内置函数 tuple 的参数并返回 py3.tuple 对象,
失败返回null

返回对象:py3TupleObject

py3Object.type()

返回类型名字

Markdown 格式