std.ffi.python Package

Function Description

The ffi.python package provides the interoperability between Cangjie and Python to be compatible with powerful computing and AI ecosystems.

This package:

1. Provides a global interpreter object Python of the PythonBuiltins type, which can be used to:

   • Load and unload interpreter resources.
   • Obtain the version of the Python interpreter in use.
   • Import and use third-party modules of Python.

   For the detailed description and use of this package, see Cangjie Programming Language Developer Guide (Cross-Language Interoperability/Interoperability with Python/PythonBuiltins Class).

2. Provides the conversion between Python data types and Cangjie data types. For example, PyBool, PyLong, PyFloat, PyString, PyTuple, PyList, PyDict, and PySet are inherited from the PyObject type. The PyObject type provides universal interfaces for all types, such as member variable access, function access, and conversion to Cangjie types. The subclasses of the PyObject type provide function interfaces specific to each type.

   For the detailed description and use of the mapping relationship, see Cangjie Programming Language Developer Guide (Cross-Language Interoperability/Interoperability with Python/Type Mapping).

3. Supports simple function registration and Python's callback of Cangjie functions. Python calls back the Cangjie code through C language and using its third-party libraries, ctypes and _ctypes.

   For the detailed description and use of the mapping relationship, see Cangjie Programming Language Developer Guide (Cross-Language Interoperability/Interoperability with Python/Callback Registration of Cangjie and Python). This section describes the type mapping between parameters and return values for callback, as well as the calling methods.

Note:

• This package is not supported on Windows.

API List

Constants and Variables

Interface

Class

Exception Class