[函数]Swoole\Buffer::substr()函数—用法及示例

函数名称：Swoole\Buffer::substr()

适用版本：Swoole扩展版本1.7.0以上

函数说明：Swoole\Buffer::substr()用于从Swoole\Buffer对象中获取子字符串。

用法：

string Swoole\Buffer::substr(int $offset[, int $length = null])

参数说明：

• $offset：必需，表示要获取的子字符串的起始位置。
• $length：可选，表示要获取的子字符串的长度。如果未指定，则默认获取从$offset到字符串末尾的所有字符。

返回值：

• 返回获取到的子字符串。

示例：

$buffer = new Swoole\Buffer(1024);
$buffer->append('Hello World');

// 获取从索引2开始的子字符串
$subString1 = $buffer->substr(2);
echo $subString1;  // 输出：llo World

// 获取从索引0开始，长度为5的子字符串
$subString2 = $buffer->substr(0, 5);
echo $subString2;  // 输出：Hello

注意事项：

• Swoole\Buffer::substr()方法仅适用于Swoole\Buffer对象，不能用于普通的PHP字符串。
• 如果传入的$offset或$length参数超出了Swoole\Buffer对象的有效范围，将会触发警告并返回空字符串。
• 如果$offset参数为负数，则表示从字符串末尾开始计数，例如-1表示倒数第一个字符。
• 如果$length参数为负数，则表示从$offset位置开始取到倒数第-length个字符。
• 如果$length参数为0，则返回空字符串。