EventBuffer::search
(PECL event >= 1.2.6-beta)
EventBuffer::search — Scans the buffer for an occurrence of a string
Beschreibung
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.
Parameter-Liste
-
what
-
String to search.
-
start
-
Start search position.
-
end
-
End search position.
Rückgabewerte
Returns numeric position of the first occurrence of the string in the
buffer, or false
if string is not found.
Diese Funktion kann sowohl das
boolsche false
zurückliefern, als auch einen nicht-boolschen Wert, welcher zu false
ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
boolschen Typen. Benutzen Sie deshalb
den === Operator,
um den Rückgabewert dieser Funktion zu überprüfen.
Beispiele
Beispiel #1 EventBuffer::search() example
<?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"));
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
int(3)
Siehe auch
- EventBuffer::searchEol() - Scans the buffer for an occurrence of an end of line