swoole源码解析之Buffer的read操作

swoole_buffer提供的read操作用于读取缓存区任意位置的内存。

swoole_buffer->read(int $offset, int $length)

此接口是一个底层接口，可直接操作内存。

• $offset 偏移量
• $length 要读取的数据长度
• 如果 $offset 错误或读取的长度超过实际数据的长度，返回 false

我们看下其实现过程。

static PHP_METHOD(swoole_buffer, read)
{
    long offset;
    long length;

    //解析输入参数，这里输入参数包括offset和length，分别表示从哪里开始读取和读取多少长度
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ll", &offset, &length) == FAILURE)
    {
        RETURN_FALSE;
    }

    swString *buffer = swoole_get_object(getThis());//获取swoole内部封装对象

    if (offset < 0)//offset小于0，表示从尾部开始读取
    {
        offset = buffer->length - buffer->offset + offset;//可能存在有废弃空间存在
    }

    if (offset < 0)//offset越界
    {
        php_error_docref(NULL TSRMLS_CC, E_WARNING, "offset(%ld) is out of bounds.", offset);
        RETURN_FALSE;
    }

    offset += buffer->offset;//更新offset信息

    if (length > buffer->length - offset)//长度信息越界
    {
        RETURN_FALSE;
    }

    SW_RETURN_STRINGL(buffer->str + offset, length, 1);//读取字符串信息
}