Base class for diff formatters. More...

Inheritance diagram for DiffFormatter:

[legend]

Public Member Functions
	format ( $diff)
	Format a diff.

Protected Member Functions
	added ( $lines)

	block ( $xbeg, $xlen, $ybeg, $ylen, &$edits)

	blockHeader ( $xbeg, $xlen, $ybeg, $ylen)

	changed ( $orig, $closing)
	Writes the two sets of lines to the output buffer, separated by "---" and a newline.

	context ( $lines)

	deleted ( $lines)

	endBlock ()
	Called at the end of a block of connected edits.

	endDiff ()

	lines ( $lines, $prefix=' ')
	Writes all (optionally prefixed) lines to the output buffer, separated by newlines.

	startBlock ( $header)
	Called at the start of a block of connected edits.

	startDiff ()

	writeOutput ( $text)
	Writes a string to the output buffer.

Protected Attributes
int	$leadingContextLines = 0
	Number of leading context "lines" to preserve.

int	$trailingContextLines = 0
	Number of trailing context "lines" to preserve.

Private Attributes
string	$result = ''
	The output buffer; holds the output while it is built.

Detailed Description

Base class for diff formatters.

This class formats the diff in classic diff format. It is intended that this class be customized via inheritance, to obtain fancier outputs.

Todo:: document

Definition at line 36 of file DiffFormatter.php.

Member Function Documentation

◆ added()

DiffFormatter::added ( $lines )

protected

Parameters

string[] $lines

Reimplemented in TableDiffFormatter, and UnifiedDiffFormatter.

Definition at line 231 of file DiffFormatter.php.

References $lines, and lines().

Referenced by block(), and changed().

◆ block()

DiffFormatter::block	(		$xbeg,
			$xlen,
			$ybeg,
			$ylen,
		&	$edits
	)

protected

Parameters

int	$xbeg
int	$xlen
int	$ybeg
int	$ylen
array	&$edits

Exceptions

MWException If the edit type is not known.

Definition at line 132 of file DiffFormatter.php.

References added(), blockHeader(), changed(), context(), deleted(), endBlock(), and startBlock().

Referenced by format().

◆ blockHeader()

DiffFormatter::blockHeader	(	$xbeg,
		$xlen,
		$ybeg,
		$ylen
	)

protected

Parameters

int	$xbeg
int	$xlen
int	$ybeg
int	$ylen

Returns: string

Reimplemented in TableDiffFormatter, and UnifiedDiffFormatter.

Definition at line 181 of file DiffFormatter.php.

Referenced by block().

◆ changed()

DiffFormatter::changed	(	$orig,
		$closing
	)

protected

Writes the two sets of lines to the output buffer, separated by "---" and a newline.

Parameters

string[]	$orig
string[]	$closing

Reimplemented in TableDiffFormatter, and UnifiedDiffFormatter.

Definition at line 248 of file DiffFormatter.php.

References added(), deleted(), and writeOutput().

Referenced by block().

◆ context()

DiffFormatter::context ( $lines )

protected

Parameters

string[] $lines

Reimplemented in TableDiffFormatter.

Definition at line 224 of file DiffFormatter.php.

References $lines, and lines().

Referenced by block().

◆ deleted()

DiffFormatter::deleted ( $lines )

protected

Parameters

string[] $lines

Reimplemented in TableDiffFormatter, and UnifiedDiffFormatter.

Definition at line 238 of file DiffFormatter.php.

References $lines, and lines().

Referenced by block(), and changed().

◆ endBlock()

DiffFormatter::endBlock ( )

protected

Called at the end of a block of connected edits.

This default implementation does nothing.

Reimplemented in TableDiffFormatter.

Definition at line 206 of file DiffFormatter.php.

Referenced by block().

◆ endDiff()

DiffFormatter::endDiff ( )

protected

Returns: string

Definition at line 166 of file DiffFormatter.php.

References $result.

Referenced by format().

◆ format()

DiffFormatter::format ( $diff )

Format a diff.

Parameters

Diff $diff

Returns: string The formatted output.

Reimplemented in ArrayDiffFormatter.

Definition at line 62 of file DiffFormatter.php.

References $context, $leadingContextLines, $trailingContextLines, block(), endDiff(), and startDiff().

◆ lines()

DiffFormatter::lines	(	$lines,
		$prefix = `' '`
	)

protected

Writes all (optionally prefixed) lines to the output buffer, separated by newlines.

Parameters

string[]	$lines
string	$prefix

Reimplemented in UnifiedDiffFormatter.

Definition at line 215 of file DiffFormatter.php.

References $line, $lines, and writeOutput().

Referenced by added(), context(), and deleted().

◆ startBlock()

DiffFormatter::startBlock ( $header )

protected

Called at the start of a block of connected edits.

This default implementation writes the header and a newline to the output buffer.

Parameters

string $header

Reimplemented in TableDiffFormatter.

Definition at line 198 of file DiffFormatter.php.

References $header, and writeOutput().

Referenced by block().

◆ startDiff()

DiffFormatter::startDiff ( )

protected

Definition at line 150 of file DiffFormatter.php.

Referenced by format().

◆ writeOutput()

DiffFormatter::writeOutput ( $text )

protected

Writes a string to the output buffer.

Parameters

string $text

Definition at line 159 of file DiffFormatter.php.

Referenced by TableDiffFormatter\added(), changed(), TableDiffFormatter\changed(), TableDiffFormatter\context(), TableDiffFormatter\deleted(), lines(), UnifiedDiffFormatter\lines(), startBlock(), and TableDiffFormatter\startBlock().

Member Data Documentation

◆ $leadingContextLines

int DiffFormatter::$leadingContextLines = 0

protected

Number of leading context "lines" to preserve.

This should be left at zero for this class, but subclasses may want to set this to other values.

Definition at line 43 of file DiffFormatter.php.

Referenced by format().

◆ $result

string DiffFormatter::$result = ''

private

The output buffer; holds the output while it is built.

Definition at line 53 of file DiffFormatter.php.

Referenced by endDiff().

◆ $trailingContextLines

int DiffFormatter::$trailingContextLines = 0

protected

Number of trailing context "lines" to preserve.

This should be left at zero for this class, but subclasses may want to set this to other values.

Definition at line 50 of file DiffFormatter.php.

Referenced by format().

The documentation for this class was generated from the following file:

includes/diff/DiffFormatter.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Member Function Documentation

◆ added()

◆ block()

◆ blockHeader()

◆ changed()

◆ context()

◆ deleted()

◆ endBlock()

◆ endDiff()

◆ format()

◆ lines()

◆ startBlock()

◆ startDiff()

◆ writeOutput()

Member Data Documentation

◆ $leadingContextLines

◆ $result

◆ $trailingContextLines