EventBuffer::search
(PECL event >= 1.2.6-beta)
EventBuffer::search — Scans the buffer for an occurrence of a string
Description
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
-
what
-
String to search.
-
start
-
Start search position.
-
end
-
End search position.
Return Values
Returns numeric position of the first occurance of the string in the
buffer, or FALSE
if string is not found.
This function may
return Boolean FALSE
, but may also return a non-Boolean value which
evaluates to FALSE
. Please read the section on Booleans for more
information. Use the ===
operator for testing the return value of this
function.
Examples
Example #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"));
?>
The above example will output something similar to:
int(3)
See Also
- EventBuffer::searchEol() - Scans the buffer for an occurrence of an end of line
- Функция EventBuffer::add() - Append data to the end of an event buffer
- Функция EventBuffer::addBuffer() - Move all data from a buffer provided to the current instance of EventBuffer
- EventBuffer::appendFrom
- Функция EventBuffer::__construct() - Constructs EventBuffer object
- Функция EventBuffer::copyout() - Copies out specified number of bytes from the front of the buffer
- EventBuffer::drain
- Функция EventBuffer::enableLocking() - Описание
- Функция EventBuffer::expand() - Reserves space in buffer
- Функция EventBuffer::freeze() - Prevent calls that modify an event buffer from succeeding
- Функция EventBuffer::lock() - Acquires a lock on buffer
- Функция EventBuffer::prepend() - Prepend data to the front of the buffer
- Функция EventBuffer::prependBuffer() - Moves all data from source buffer to the front of current buffer
- EventBuffer::pullup
- Функция EventBuffer::read() - Read data from an evbuffer and drain the bytes read
- Функция EventBuffer::readFrom() - Read data from a file onto the end of the buffer
- Функция EventBuffer::readLine() - Extracts a line from the front of the buffer
- Функция EventBuffer::search() - Scans the buffer for an occurrence of a string
- Функция EventBuffer::searchEol() - Scans the buffer for an occurrence of an end of line
- Функция EventBuffer::substr() - Substracts a portion of the buffer data
- Функция EventBuffer::unfreeze() - Re-enable calls that modify an event buffer
- Функция EventBuffer::unlock() - Releases lock acquired by EventBuffer::lock
- Функция EventBuffer::write() - Write contents of the buffer to a file or socket
Коментарии
404 Not Found