PyObject

PyObject 是除了 PyCore 之外，所有其他类型的基类。非内置类的对象是 PyObject 的实例。PyObject 实现了 4 个魔术方法，用于将操作映射到 Python 对象。

所有类方法、参数、返回值参考 stubs 目录中的文件，文档不再介绍。

内置类

  • PyObject：所有其他类型的基类
  • PyDict：字典类型，等同于 PHP 的关联数组
  • PyList：列表类型，等同于 PHP 的索引数组
  • PyTuple：元组，不可变的列表
  • PyStr：字符串
  • PyModule：Python 包，PyModule 也是 PyObject 的子类

继承关系

  1. PyObject -> PyModule
  2.          -> PySequenece -> PyList
  3.                         -> PyTuple
  4.          -> PySet
  5.          -> PyStr
  6.          -> PyDict
  7.          -> PyType

__get($name)

读取 Python 对象的属性，以下操作是等价的

  1. $pyobj->attr;
  1. pyobj.attr

__set($name, $value)

设置 Python 对象的属性，以下操作是等价的

  1. $pyobj->attr = 'hello';
  1. pyobj.attr = 'hello'

__call($name, $args)

调用 Python 对象的方法，以下操作是等价的

  1. $pyobj->fn($a, $b, $c);
  1. pyobj.fn(a, b, c)

__invoke(…$args)

执行 callable 对象，通常用于执行函数、构造对象。以下操作是等价的

  1. // $user 是一个 PyModule
  2. $user = PyCore::import('app.user');
  3. // Info 是 app.user 中的一个类
  4. $Info = $user->Info;
  5. // 创建一个 Info 对象
  6. $info = $Info('Rango', 2023);
  1. from app.user import Info
  3. // 创建一个 Info 对象
  4. info = Info('Rango', 2023);

命名参数

支持命名参数写法。实例：

传入命名参数

  1. kwargs($a, $b, $c, name: 'hello', world: 'rango');
  • 顺序参数必须在前，命名参数必须在最后

接收命名参数

  1. function kwargs($a, $b, $c, $name, $world) {
  3. }

可变命名参数

  1. function kwargs(...$kwargs) {
  2.     var_dump($kwargs);
  3. }
  • $kwargs 将包含顺序参数和命名参数两部分，例如刚才的例子中就或获得
    1. array(
    2. 0 => $a,
    3. 1 => $b,
    4. 2 => $c,
    5. 'name' => 'hello',
    6. 'world' => 'rango',
    7. )

透传命名参数

  1. function kwargs(...$kwargs) {
  2.     kwargs_fn2(...$kwargs);
  3. }

可将命名参数传递给另外函数。