interface InputStream in Zircon Profile 8

Interface for stream readers.

The parser only reads from streams. Various input sources can write an adapater to this InputStream.

Currently provided InputStream implementations include FileInputStream and StringInputStream.

Hierarchy

• interface \Masterminds\HTML5\Parser\InputStream extends \Masterminds\HTML5\Parser\Iterator

File

vendor/masterminds/html5/src/HTML5/Parser/InputStream.php, line 13

Namespace

Masterminds\HTML5\Parser

interface InputStream extends \Iterator {

  /**
   * Returns the current line that is being consumed.
   *
   * TODO: Move this to the scanner.
   */
  public function currentLine();

  /**
   * Returns the current column of the current line that the tokenizer is at.
   *
   * Newlines are column 0. The first char after a newline is column 1.
   *
   * @TODO Move this to the scanner.
   *
   * @return int The column number.
   */
  public function columnOffset();

  /**
   * Get all characters until EOF.
   *
   * This consumes characters until the EOF.
   */
  public function remainingChars();

  /**
   * Read to a particular match (or until $max bytes are consumed).
   *
   * This operates on byte sequences, not characters.
   *
   * Matches as far as possible until we reach a certain set of bytes
   * and returns the matched substring.
   *
   * @see strcspn
   * @param string $bytes
   *            Bytes to match.
   * @param int $max
   *            Maximum number of bytes to scan.
   * @return mixed Index or false if no match is found. You should use strong
   *         equality when checking the result, since index could be 0.
   */
  public function charsUntil($bytes, $max = null);

  /**
   * Returns the string so long as $bytes matches.
   *
   * Matches as far as possible with a certain set of bytes
   * and returns the matched substring.
   *
   * @see strspn
   * @param string $bytes
   *            A mask of bytes to match. If ANY byte in this mask matches the
   *            current char, the pointer advances and the char is part of the
   *            substring.
   * @param int $max
   *            The max number of chars to read.
   */
  public function charsWhile($bytes, $max = null);

  /**
   * Unconsume one character.
   *
   * @param int $howMany
   *            The number of characters to move the pointer back.
   */
  public function unconsume($howMany = 1);

  /**
   * Retrieve the next character without advancing the pointer.
   */
  public function peek();

}

Members

Name	Modifiers	Type	Description	Overrides
InputStream::charsUntil	public	function	Read to a particular match (or until $max bytes are consumed).	1
InputStream::charsWhile	public	function	Returns the string so long as $bytes matches.	1
InputStream::columnOffset	public	function	Returns the current column of the current line that the tokenizer is at.	1
InputStream::currentLine	public	function	Returns the current line that is being consumed.	1
InputStream::peek	public	function	Retrieve the next character without advancing the pointer.	1
InputStream::remainingChars	public	function	Get all characters until EOF.	1
InputStream::unconsume	public	function	Unconsume one character.	1