Online PHP editor | rfc for cV6EX

@ 2014-05-06T10:54:21Z

<?php

namespace Rixxi\Utils;


class Batch implements \ArrayAccess
{

	/** @var int */
	private $limit;

	/** @var int */
	private $counter = 0;

	/** @var callable */
	private $onFlush;

	/** @var array */
	private $values = array();


	/**
	 * Callback will receive all appended values as an array. When limit is reached flush is triggered.
	 *
	 * @param callable
	 * @param int
	 */
	public function __construct(callable $onFlush, $limit = 1000)
	{
		$this->onFlush = $onFlush;
		$this->limit = $limit;
	}


	public function __destruct()
	{
		$this->flush();
	}


	/**
	 * Adds value to batch. If limit is reached flush is triggered immediately.
	 *
	 * @param mixed
	 */
	public function append($value)
	{
		$this->values[] = $value;
		if (++$this->counter === $this->limit) {
			$this->flush();
		}
	}


	/**
	 * If at least one value was appended, calls callback and resets state.
	 */
	public function flush()
	{
		if ($this->counter !== 0) {
			$onFlush = $this->onFlush; // performance optimization
			$onFlush($this->values);
			$this->values = array();
			$this->counter = 0;
		}
	}


	public function offsetExists($index)
	{
		throw new NotSupportedException('Checking existence of index is not supported use callback instead.');
	}


	public function offsetGet($index)
	{
		throw new NotSupportedException('Retrieving values via index is not supported use callback instead.');
	}


	public function offsetSet($index, $value)
	{
		if ($index !== NULL) {
			throw new InvalidArgumentException('Setting values via index is not supported use append instead.');
		}

		$this->append($value);
	}


	public function offsetUnset($index)
	{
		throw new NotSupportedException('Batch is append only.');
	}

}

Output for git.master, git.master_jit, rfc.property-hooks: Deprecated: Return type of Rixxi\Utils\Batch::offsetExists($index) should either be compatible with ArrayAccess::offsetExists(mixed $offset): bool, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /in/cV6EX on line 69 Deprecated: Return type of Rixxi\Utils\Batch::offsetGet($index) should either be compatible with ArrayAccess::offsetGet(mixed $offset): mixed, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /in/cV6EX on line 75 Deprecated: Return type of Rixxi\Utils\Batch::offsetSet($index, $value) should either be compatible with ArrayAccess::offsetSet(mixed $offset, mixed $value): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /in/cV6EX on line 81 Deprecated: Return type of Rixxi\Utils\Batch::offsetUnset($index) should either be compatible with ArrayAccess::offsetUnset(mixed $offset): void, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in /in/cV6EX on line 91

This tab shows result from various feature-branches currently under review by the php developers. Contact me to have additional branches featured.

Active branches

Archived branches

Once feature-branches are merged or declined, they are no longer available. Their functionality (when merged) can be viewed from the main output page

2020-03-21 RFC: Is_Literal - declined
2020-12-04 Enumerations - included in PHP 8.1
2018-06-15 Typed Properties v2 - implemented in PHP 7.4
2016-08-12 Object typehint - included in PHP 7.2
2016-08-14 Arrow functions - withdrawn
2016-05-29 array_change_keys() - withdrawn
2016-04-19 Lexical scope support for anonymous classes - suspended
2016-04-17 Functional Interfaces - declined
2016-03-16 Typed Properties - superseded in favor of Typed Properties 2.0
2015-08-27 Callable Prototypes - declined
2015-05-01 Short Closures - declined / withdrawn in favor of Arrow Functions
2015-02-18 Scalar type hints v5 - included in PHP 7
2015-02-14 Union Types - declined
2013-09-22 Anonymous classes - included in PHP 7

preferences:dark modelive preview