दस्तावेज़ तुलना

दस्तावेज़ तुलना

यह गाइड दिखाता है कि दो टेक्स्ट रन की तुलना कैसे करें और उनके बीच संपादन क्रम उत्पन्न करें Aspose.PDF FOSS टेक्स्ट-डिफ इंजन का उपयोग करके .NET के लिए। इस तुलना मॉडल का प्रवेश बिंदु है DiffOperation, एक एकल संपादन जो टैग किया गया है Operation (Equal, Delete, या Insert), साथ में DiffUtils सहायक क्लास सामान्य टेक्स्ट को खोजने और डिफ को उसके स्रोत और गंतव्य टेक्स्ट में पुनः संयोजित करने के लिए। एक अलग अनुकूलन पास, जो वर्णित है डिफ अनुकूलन, इस प्रकार उत्पन्न कच्चा डिफ आउटपुट को मानकीकृत करता है इससे पहले कि इसे रेंडर या लागू किया जाए।

डिफ मॉडल: संचालन और DiffOperation

Operation वह एनम है जो डिफ में प्रत्येक संपादन को वर्गीकृत करता है: Equal उन अपरिवर्तित पाठ के भाग को चिह्नित करता है, Delete स्रोत से हटाए गए भाग को चिह्नित करता है, और Insert गंतव्य में जोड़े गए भाग को चिह्नित करता है। DiffOperation एक Operation मान को उस Text के साथ जोड़ता है जिस पर यह लागू होता है, और IEquatable<DiffOperation> को लागू करता है ताकि दो संपादनों की समानता की तुलना की जा सके।

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 एक स्थैतिक हेल्पर क्लास है जिसे डिफ इंजन द्वारा दो स्ट्रिंग्स के बीच साझा सामान्य प्रीफ़िक्स और सफ़िक्स को खोजने के लिए उपयोग किया जाता है, इससे पहले कि विभिन्न मध्य भाग का डिफ किया जाए। 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);

डिफ से पाठ को पुनः संयोजित करना

जब कोई diff एक अनुक्रम 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 का उपयोग करें, न कि रेफ़रेंस समानता का।
• पहले FindCommonStartParts के साथ सामान्य उपसर्ग को खोजें, फिर उसकी लंबाई को FindCommonEndParts के startIndex ओवरलोड में पास करें ताकि छोटा सामान्य उपसर्ग दुगुना गिना न जाए और उपसर्ग का हिस्सा न बन जाए।
• AssemblySourceText और AssemblyDestinationText का उपयोग करके DiffOperation मानों की अनुक्रमणिका को सत्यापित करें कि वह सटीक मूल और संशोधित पाठ तक राउंड-ट्रिप करता है, इससे पहले कि आप इसे कहीं और उपयोग करें।
• विज़ुअल diff रेंडर करते समय Operation.Equal रन को नो-ऑप के रूप में मानें, और केवल Delete और Insert रन को हाइलाइट करें।
• यह इंजन सीधे दस्तावेज़ों का डिफ़ नहीं बनाता — तुलना करने के लिए इच्छित टेक्स्ट निकालें (उदाहरण के लिए, किसी पेज या दस्तावेज़ से) डिफ़ बनाने से पहले।

सामान्य समस्याएँ

FAQ

डिफ़ इंजन क्या तुलना करता है?

यह टेक्स्ट के क्रम की तुलना करता है और DiffOperation मानों की एक श्रृंखला उत्पन्न करता है जो संपादन का वर्णन करती है — अपरिवर्तित, हटाया गया, या सम्मिलित किया गया टेक्स्ट — जो एक स्ट्रिंग को दूसरी में बदलने के लिए आवश्यक हैं।

Operation कौन से संपादन प्रकारों का समर्थन करता है?

तीन: अपरिवर्तित टेक्स्ट के लिए Equal, स्रोत से हटाए गए टेक्स्ट के लिए Delete, और गंतव्य में जोड़े गए टेक्स्ट के लिए Insert।

मैं कैसे जाँचूँ कि दो संपादन समान हैं या नहीं?

एक DiffOperation इंस्टेंस पर Equals को कॉल करें, या उसके Operation और Text प्रॉपर्टीज़ की सीधे तुलना करें।

क्या मैं एक diff से मूल और संशोधित पाठ वापस प्राप्त कर सकता हूँ?

हाँ — मूल पाठ के लिए DiffOperation मानों की सूची को DiffUtils.AssemblySourceText को पास करें और संशोधित पाठ के लिए DiffUtils.AssemblyDestinationText को पास करें।

क्या यह पेज एक diff को मर्ज करने या साफ़ करने को कवर करता है?

नहीं — कच्चे diff (सन्निकट रन को मिलाना, समानताओं के पार संपादन को स्लाइड करना) को मानकीकृत करना अलग से शामिल है डिफ ऑप्टिमाइज़ेशन.

API Reference सारांश

यह भी देखें

• Aspose.PDF for .NET — Enterprise Documentation