A class containing functions for computing diffs and formatting the output. More...

Collaboration diagram for Diff:

Static Public Member Functions
static	compare ($string1, $string2, $compareCharacters=false)
	Returns the diff for two strings.

static	compareFiles ( $file1, $file2, $compareCharacters=false)
	Returns the diff for two files.

static	toString ($diff, $separator="\n")
	Returns a diff as a string, where unmodified lines are prefixed by ' ', deletions are prefixed by '- ', and insertions are prefixed by '+ '.

static	toHTML ($diff, $separator='< br >')
	Returns a diff as an HTML string, where unmodified lines are contained within 'span' elements, deletions are contained within 'del' elements, and insertions are contained within 'ins' elements.

static	toTable ($diff, $indentation='', $separator='< br >')
	Returns a diff as an HTML table.

Static Private Member Functions
static	computeTable ($sequence1, $sequence2, $start, $end1, $end2)
	Returns the table of longest common subsequence lengths for the specified sequences.

static	generatePartialDiff ($table, $sequence1, $sequence2, $start)
	Returns the partial diff for the specificed sequences, in reverse order.

static	getCellContent ($diff, $indentation, $separator, &$index, $type)
	Returns the content of the cell, for use in the toTable function.

Detailed Description

A class containing functions for computing diffs and formatting the output.

We can compare 2 strings or 2 files (as one string or line by line)

Definition at line 17 of file utils_diff.class.php.

Member Function Documentation

◆ compare()

static Diff::compare	(	$string1,
		$string2,
		$compareCharacters = false )

static

Returns the diff for two strings.

The return value is an array, each of whose values is an array containing two values: a line (or character, if $compareCharacters is true), and one of the constants DIFF\UNMODIFIED (the line or character is in both strings), DIFF\DELETED (the line or character is only in the first string), and DIFF\INSERTED (the line or character is only in the second string). The parameters are:

Parameters

string	$string1	First string
string	$string2	Second string
string	$compareCharacters	true to compare characters, and false to compare lines; this optional parameter defaults to false

Returns: array Array of diff

Definition at line 37 of file utils_diff.class.php.

References computeTable(), and generatePartialDiff().

Referenced by compareFiles().

◆ compareFiles()

static Diff::compareFiles	(	$file1,
		$file2,
		$compareCharacters = false )

static

Returns the diff for two files.

The parameters are:

Parameters

string	$file1	Path to the first file
string	$file2	Path to the second file
boolean	$compareCharacters	true to compare characters, and false to compare lines; this optional parameter defaults to false

Returns: array Array of diff

Definition at line 98 of file utils_diff.class.php.

References compare().

◆ computeTable()

static Diff::computeTable	(	$sequence1,
		$sequence2,
		$start,
		$end1,
		$end2 )

staticprivate

Returns the table of longest common subsequence lengths for the specified sequences.

The parameters are:

Parameters

string	$sequence1	the first sequence
string	$sequence2	the second sequence
string	$start	the starting index
string	$end1	the ending index for the first sequence
string	$end2	the ending index for the second sequence

Returns: array array of diff

Definition at line 122 of file utils_diff.class.php.

Referenced by compare().

◆ generatePartialDiff()

static Diff::generatePartialDiff	(	$table,
		$sequence1,
		$sequence2,
		$start )

staticprivate

Returns the partial diff for the specificed sequences, in reverse order.

The parameters are:

Parameters

string	$table	the table returned by the computeTable function
string	$sequence1	the first sequence
string	$sequence2	the second sequence
string	$start	the starting index

Returns: array array of diff

Definition at line 162 of file utils_diff.class.php.

Referenced by compare().

◆ getCellContent()

static Diff::getCellContent	(		$diff,
			$indentation,
			$separator,
		&	$index,
			$type )

staticprivate

Returns the content of the cell, for use in the toTable function.

The parameters are:

Parameters

array	$diff	the diff array
string	$indentation	indentation to add to every line of the generated HTML
string	$separator	the separator between lines
string	$index	the current index, passes by reference
string	$type	the type of line

Returns: string HTML string

Definition at line 377 of file utils_diff.class.php.

Referenced by toTable().

◆ toHTML()

static Diff::toHTML	(		$diff,
			$separator = '<br>' )

static

Returns a diff as an HTML string, where unmodified lines are contained within 'span' elements, deletions are contained within 'del' elements, and insertions are contained within 'ins' elements.

The parameters are:

Parameters

array	$diff	the diff array
string	$separator	the separator between lines; this optional parameter defaults to ' '

Returns: string HTML string

Definition at line 244 of file utils_diff.class.php.

References dol_escape_htmltag().

◆ toString()

static Diff::toString	(		$diff,
			$separator = "\n" )

static

Returns a diff as a string, where unmodified lines are prefixed by ' ', deletions are prefixed by '- ', and insertions are prefixed by '+ '.

The parameters are:

Parameters

array	$diff	the diff array
string	$separator	the separator between lines; this optional parameter defaults to "\n"

Returns: string String

Definition at line 207 of file utils_diff.class.php.

◆ toTable()

static Diff::toTable	(	$diff,
		$indentation = '',
		$separator = '<br>' )

static

Returns a diff as an HTML table.

The parameters are:

Parameters

array	$diff	the diff array
string	$indentation	indentation to add to every line of the generated HTML; this optional parameter defaults to ''
string	$separator	the separator between lines; this optional parameter defaults to ' '

Returns: string HTML string

Definition at line 282 of file utils_diff.class.php.

References getCellContent().

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

dolibarr_19.0/htdocs/core/class/utils_diff.class.php

Static Public Member Functions

Static Private Member Functions

Detailed Description

Member Function Documentation

◆ compare()

◆ compareFiles()

◆ computeTable()

◆ generatePartialDiff()

◆ getCellContent()

◆ toHTML()

◆ toString()

◆ toTable()