Class StringBuffer

source/binding/Python/maa/buffer.py:11–115

字符串缓冲区 / String buffer 用于在 Python 和 C API 之间传递字符串数据。 Used to pass string data between Python and C API.

class StringBuffer:
    """字符串缓冲区 / String buffer

    用于在 Python 和 C API 之间传递字符串数据。
    Used to pass string data between Python and C API.
    """

    _handle: MaaStringBufferHandle
    _own: bool

    def __init__(self, handle: Optional[MaaStringBufferHandle] = None):
        self._set_api_properties()

        if handle:
            self._handle = handle
            self._own = False
        else:
            self._handle = Library.framework().MaaStringBufferCreate()
            self._own = True

        if not self._handle:
            raise RuntimeError("Failed to create string buffer.")

    def __del__(self):
        if self._handle and self._own:
            Library.framework().MaaStringBufferDestroy(self._handle)

    def get(self) -> str:
        """获取缓冲区内容 / Get buffer content

        Returns:
            str: 字符串内容 / String content
        """
        buff = Library.framework().MaaStringBufferGet(self._handle)
        sz = Library.framework().MaaStringBufferSize(self._handle)
        return ctypes.string_at(buff, sz).decode()

    def set(self, value: Union[str, bytes]) -> bool:
        """设置缓冲区内容 / Set buffer content

        Args:
            value: 字符串或字节数据 / String or bytes data

        Returns:
            bool: 是否成功 / Whether successful
        """
        if isinstance(value, str):
            value = value.encode()
        return bool(Library.framework().MaaStringBufferSetEx(self._handle, value, len(value)))

    @property
    def empty(self) -> bool:
        """判断缓冲区是否为空 / Check if buffer is empty

        Returns:
            bool: 是否为空 / Whether empty
        """
        return bool(Library.framework().MaaStringBufferIsEmpty(self._handle))