wp_text_diff

（2.6.0以降）
wp_text_diff - 2つの文字列を比較する

説明

string wp_text_diff( string $left_string, string $right_string [ , mixed $args = null ] )

2つの文字列を比較する。

パラメータ

$left_string
古い方の文字列を指定。
$right_string
新しい方の文字列を指定。

$args

取得条件を連想配列または文字列で指定（省略時はnull）。主なキーは次の通り。

キー	内容	省略時の値
'show_split_view'	比較結果を左右で表示する場合はtrueを指定	true
'title'	表全体のタイトルを指定	''
'title_left'	$left_stringのタイトルを指定	''
'title_right'	$right_stringのタイトルを指定	''

返り値

文字列の違いを示すHTML（table要素）を返す。違いがない場合は空の文字列を返す。

注意

比較は行単位で行われ、左右比較モード（'show_split_view'がtrue）では、以下のような内容になる。

違い	左側	右側
古い方のみにある	td要素はdiff-deletedlineクラス	空
新しい方のみにある	空	td要素はdiff-addedlineクラス
内容が異なる	td要素はdiff-deletedlineクラス	td要素はdiff-addedlineクラス

単一モード（'show_split_view'がfalse）では、以下のような内容になる。

違い	左側
古い方のみにある	td要素はdiff-deletedlineクラス
新しい方のみにある	td要素はdiff-addedlineクラス
内容が異なる	1行目のtd要素はdiff-deletedlineクラス、2行目のtd要素はdiff-addedlineクラス

なおパラメータ$argsに'title'、'title_left'、'title_right'のいずれかを指定するとthead要素内が4カラムになり、tbody要素内とカラム数が異なってしまい、意図した表示にならない（バージョン4.9.8で確認）。タイトルを付けたい場合は本関数を使用せず、本関数を参考にして独自に実装する方がいいだろう。

使用例

投稿とリビジョンの本文部分を比較し、結果を左右比較モードで表示する。
<?php echo wp_text_diff( $revisions[0]->post_content, $post->post_content ); ?>
投稿とリビジョンの本文部分を比較し、結果を単一モードで表示する。
<?php echo wp_text_diff( $revisions[0]->post_content, $post->post_content, array( 'show_split_view' => false ) ); ?>