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);//读取字符串信息
}