EventBuffer::search
(PECL event >= 1.2.6-beta)
EventBuffer::search — Scans the buffer for an occurrence of a string
Opis
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.
Parametry
-
what -
String to search.
-
start -
Start search position.
-
end -
End search position.
Zwracane wartości
Returns numeric position of the first occurance of the string in the
buffer, or FALSE if string is not found.
Ta funkcja może
zwrócić Boolean FALSE, ale może też zwrócić wartość innego typu niż Boolean, która oznacza
wartość FALSE. Aby uzyskać więcej informacji proszę zapoznać się z rozdziałem Typy logiczne.
Można używać operatora ===
do testowania zwracanych wartości przez tę
funkcję.
Przykłady
Przykład #1 EventBuffer::search() example
<?php
// Count total occurances 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"));
?>
Powyższy przykład wyświetli coś podobnego do:
int(3)
Zobacz też:
- EventBuffer::searchEol() - Scans the buffer for an occurrence of an end of line
add a note
