EventBuffer::search
PHP function
Edit on GitHub ✎
(PECL event >= 1.2.6-beta)
Scans the buffer for an occurrence of a string
Description
EventBuffer::search(string $what, int $start = -1, int $end = -1): mixed
Scans the buffer for an occurrence of the string what. It returns numeric position of the string, or false if the string was not found.
If the start argument is provided, it points to the position at which the search should begin; otherwise, the search is performed from the start of the string. If end argument provided, the search is performed between start and end buffer positions.
Parameters
whatString to search.
startStart search position.
endEnd search position.
Return Values
Returns numeric position of the first occurrence of the string in the buffer, or false if string is not found.
Falseproblem
Examples
EventBuffer::search() example
php
<?php
// Count total occurrences of 'str' in 'buf'
function count_instances($buf, $str) {
$total = 0;
$p = 0;
$i = 0;
while (1) {
$p = $buf->search($str, $p);
if ($p === FALSE) {
break;
}
++$total;
++$p;
}
return $total;
}
$buf = new EventBuffer();
$buf->add("Some string within a string inside another string");
var_dump(count_instances($buf, "str"));
?>The above example will output something similar to:
output
int(3)See Also
EventBuffer::searchEol