Homec4science
Diffusion libphutil (production) Browse

libphutil/src/utils/PhutilRope.php
32f1dad1f4e5production

Last Change
Raw File

PhutilRope.php
View Options

<?php
/**
* String-like object which reduces the cost of managing large strings. This
* is particularly useful for buffering large amounts of data that is being
* passed to `fwrite()`.
*/
final class PhutilRope extends Phobject {
private $length = 0;
private $buffers = array();
// This is is arbitrary, it's just the maximum size I'm reliably able to
// fwrite() to a pipe on OSX. In theory, we could tune this slightly based
// on the pipe buffer size, but any value similar to this shouldn't affect
// performance much.
private $segmentSize = 16384;
/**
* Append a string to the rope.
*
* @param string String to append.
* @return this
*/
public function append($string) {
if (!strlen($string)) {
return $this;
}
$len = strlen($string);
$this->length += $len;
if ($len <= $this->segmentSize) {
$this->buffers[] = $string;
} else {
for ($cursor = 0; $cursor < $len; $cursor += $this->segmentSize) {
$this->buffers[] = substr($string, $cursor, $this->segmentSize);
}
}
return $this;
}
/**
* Get the length of the rope.
*
* @return int Length of the rope in bytes.
*/
public function getByteLength() {
return $this->length;
}
/**
* Get an arbitrary, nonempty prefix of the rope.
*
* @return string Some rope prefix.
*/
public function getAnyPrefix() {
$result = reset($this->buffers);
if ($result === false) {
return null;
}
return $result;
}
/**
* Return the entire rope as a normal string.
*
* @return string Normal string.
*/
public function getAsString() {
return implode('', $this->buffers);
}
/**
* Remove a specified number of bytes from the head of the rope.
*
* @param int Bytes to remove.
* @return this
*/
public function removeBytesFromHead($length) {
if ($length <= 0) {
throw new InvalidArgumentException(
pht('Length must be larger than 0!'));
}
$remaining_length = $length;
foreach ($this->buffers as $key => $buf) {
$len = strlen($buf);
if ($len <= $length) {
unset($this->buffers[$key]);
$remaining_length -= $len;
if (!$remaining_length) {
break;
}
} else {
$this->buffers[$key] = substr($buf, $length);
break;
}
}
if ($length <= $this->length) {
$this->length -= $length;
} else {
$this->length = 0;
}
return $this;
}
}
c4science · Help