WordAccumulator.php

Go to the documentation of this file.

<?php
namespace Wikimedia\Diff;
 
class WordAccumulator {
    public $insClass = ' class="diffchange diffchange-inline"';
    public $delClass = ' class="diffchange diffchange-inline"';
 
    private $lines = [];
    private $line = '';
    private $group = '';
    private $tag = '';
 
    private function flushGroup( $new_tag ) {
        if ( $this->group !== '' ) {
            $encGroup = htmlspecialchars( $this->group, ENT_NOQUOTES );
            if ( $this->tag == 'ins' ) {
                $this->line .= "<ins{$this->insClass}>$encGroup</ins>";
            } elseif ( $this->tag == 'del' ) {
                $this->line .= "<del{$this->delClass}>$encGroup</del>";
            } else {
                $this->line .= $encGroup;
            }
        }
        $this->group = '';
        $this->tag = $new_tag;
    }
 
    private function flushLine( $new_tag ) {
        $this->flushGroup( $new_tag );
        if ( $this->line != '' ) {
            $this->lines[] = $this->line;
        } else {
            # make empty lines visible by inserting an NBSP
            $this->lines[] = "\u{00A0}";
        }
        $this->line = '';
    }
 
    public function addWords( $words, $tag = '' ) {
        if ( $tag != $this->tag ) {
            $this->flushGroup( $tag );
        }
 
        foreach ( $words as $word ) {
            // new-line should only come as first char of word.
            if ( $word == '' ) {
                continue;
            }
            if ( $word[0] == "\n" ) {
                $this->flushLine( $tag );
                $word = substr( $word, 1 );
            }
            // FIXME: Don't use assert()
            // phpcs:ignore MediaWiki.Usage.ForbiddenFunctions.assert
            assert( !str_contains( $word, "\n" ) );
            $this->group .= $word;
        }
    }
 
    public function getLines() {
        $this->flushLine( '~done' );
 
        return $this->lines;
    }
}
 
class_alias( WordAccumulator::class, 'MediaWiki\\Diff\\WordAccumulator' );