ドキュメント比較
概要
このガイドでは、Aspose.PDF FOSS テキスト差分エンジン(.NET 用)を使用して、テキストの 2 つの実行を比較し、それらの間の編集シーケンスを生成する方法を示します。 この比較モデルのエントリーポイントは DiffOperation, 単一の編集で、タグ付けされた Operation (Equal, Delete, または Insert), 一緒に DiffUtils 共通テキストを検索し、差分を元のテキストと宛先テキストに再構築するためのヘルパークラス。 別の最適化パスは、以下で説明されています 差分最適化, この方法で生成された生の差分出力を、表示または適用される前に正規化します。
差分モデル: 操作と DiffOperation
Operation は、差分内の各編集を分類する列挙型です。Equal は変更されていないテキストの連続を示し、Delete はソースから削除された連続を示し、Insert は宛先に追加された連続を示します。DiffOperation は Operation の値とそれが適用される Text をペアにし、IEquatable<DiffOperation> を実装して 2 つの編集を等価性で比較できるようにします。
using Aspose.Pdf.Comparison.Diff;
// A single edit consists of an Operation and the run of text it applies to.
var unchanged = new DiffOperation(Operation.Equal, "Aspose.PDF ");
var removed = new DiffOperation(Operation.Delete, "for .NET Framework");
var added = new DiffOperation(Operation.Insert, "FOSS for .NET");
Console.WriteLine(unchanged.Operation); // Equal
Console.WriteLine(added.Text); // "FOSS for .NET"共通テキストの検索 (DiffUtils)
DiffUtils は、差分エンジンが差分対象の中間部分を比較する前に、2 つの文字列が共有する共通のプレフィックスとサフィックスを見つけるために使用される静的ヘルパークラスです。FindCommonStartParts は共通プレフィックスを検索し、FindCommonEndParts は共通サフィックスを検索します。FindCommonEndParts のオーバーロードは startIndex を受け取り、サフィックス検索を既に見つかったプレフィックスに続くテキストに限定できるようにします。
string original = "The quick brown fox";
string revised = "The quick red fox jumps";
var commonStart = DiffUtils.FindCommonStartParts(original, revised);
var commonEnd = DiffUtils.FindCommonEndParts(original, revised);差分からテキストを再構築する
差分が DiffOperation 値のシーケンスとして表現されると、DiffUtils は比較のいずれかの側を再構築できます。AssemblySourceText は Equal と Delete ランから元のテキストを再構築し、AssemblyDestinationText は Equal と Insert ランから改訂テキストを再構築します。
using System.Collections.Generic;
var diffs = new List<DiffOperation>
{
new DiffOperation(Operation.Equal, "The quick "),
new DiffOperation(Operation.Delete, "brown"),
new DiffOperation(Operation.Insert, "red"),
new DiffOperation(Operation.Equal, " fox")
};
string sourceText = DiffUtils.AssemblySourceText(diffs);
string destinationText = DiffUtils.AssemblyDestinationText(diffs);
Console.WriteLine(sourceText); // "The quick brown fox"
Console.WriteLine(destinationText); // "The quick red fox"編集の比較と報告
DiffOperation は Equals、GetHashCode、ToString をオーバーライドするため、編集を等価性で比較したり、余分な変換コードなしでログやテスト出力に書き込んだりできます。
var a = new DiffOperation(Operation.Equal, "PDF");
var b = new DiffOperation(Operation.Equal, "PDF");
bool same = a.Equals(b); // true - same Operation and Text
Console.WriteLine(a.ToString());ヒントとベストプラクティス
DiffOperationは不変でありIEquatable<DiffOperation>を実装しています — 参照の等価性ではなく、Equalsを使用して 2 つの編集を比較してください。- まず
FindCommonStartPartsで共通プレフィックスを見つけ、次にその長さをFindCommonEndPartsのstartIndexオーバーロードに渡すことで、短い共通プレフィックスがサフィックスの一部として二重にカウントされるのを防ぎます。 - 他の場所で使用する前に、
AssemblySourceTextとAssemblyDestinationTextを使ってDiffOperation値のシーケンスが元のテキストと改訂テキストに正確に往復できることを検証してください。 - ビジュアル差分をレンダリングする際、
Operation.Equalランは何もしないものとして扱い、DeleteとInsertランのみをハイライトします。 - このエンジンはテキストの差分を取ります — ドキュメントそのものではなく、比較したいテキストを抽出して(例: ページやドキュメントから)差分を作成してください。
一般的な問題
| 問題 | 原因 | 修正 |
|---|---|---|
AssemblySourceText / AssemblyDestinationText の出力が元と一致しません | diffs リストが不完全であるか、DiffOperation エントリが順序通りでありません | シーケンス内のすべての編集を、編集が発生した元の順序で含めてください |
FindCommonEndParts は短く、類似した文字列で予期しない結果を返します | 共通サフィックス検索が、すでに FindCommonStartParts によってマッチしたテキストと重複しています | FindCommonStartParts が返す長さを startIndex 引数として渡してください |
Equals は、見た目が同一の編集に対して false を返します | Text の値は空白または大文字小文字が異なります | 比較しようとする DiffOperation の値を作成する前に、テキストを正規化(トリム/ケースフォールド)してください |
| Diff の出力が騒がしい、または不必要に断片的に見える | 生の DiffOperation シーケンスはまだ標準化されていません | 以下で説明されている最適化パスをシーケンスに適用してください 差分最適化 |
FAQ
Diffエンジンは何を比較しますか?
テキストの連続を比較し、DiffOperation 値のシーケンスを生成します — 変更されていないテキスト、削除されたテキスト、または挿入されたテキスト — を表し、ある文字列を別の文字列に変換するために必要です。
Operation がサポートする編集タイプは何ですか?
3つあります: 変更されていないテキストは Equal、ソースから削除されたテキストは Delete、宛先に追加されたテキストは Insert です。
2つの編集が同じかどうかを確認するにはどうすればよいですか?
Equals を DiffOperation インスタンスで呼び出すか、またはその Operation と Text プロパティを直接比較します。
diff から元のテキストと修正後のテキストを取得できますか?
はい — 元のテキストには DiffOperation のリストを DiffUtils.AssemblySourceText に、修正後のテキストには DiffUtils.AssemblyDestinationText に渡してください。
このページは diff のマージやクリーンアップについて扱っていますか?
いいえ — 生の差分を正準化する(隣接するランをマージし、等価部分をまたいで編集をスライドさせる)は別途で取り上げられています 差分最適化.
API Reference 概要
| クラス / メソッド | 説明 |
|---|---|
Operation | 編集を Equal、Delete、または Insert と分類する列挙型 |
DiffOperation | 単一の編集:Operation と、それが適用される Text のペア |
DiffOperation.Operation | この編集のOperation値 |
DiffOperation.Text | この編集が適用されるテキストの連続部分 |
DiffOperation.Equals | OperationとTextで二つの編集の等価性を比較する |
DiffOperation.ToString | 編集を文字列としてログまたは表示用にレンダリングする |
DiffUtils | テキスト差分ユーティリティを備えた静的ヘルパークラス |
DiffUtils.FindCommonStartParts | 2つの文字列が共有する共通の接頭辞を見つけます |
DiffUtils.FindCommonEndParts | 2つの文字列が共有する共通の接尾辞を、オプションでインデックスから開始して見つけます |
DiffUtils.AssemblySourceText | リストの DiffOperation 値から元のテキストを再構築します |
DiffUtils.AssemblyDestinationText | リストの DiffOperation 値から改訂されたテキストを再構築します |