कैसे काम करें Facades API के साथ Aspose.PDF FOSS for C++ में

Aspose.PDF FOSS for C++ उच्च-स्तरीय फ़ेसाद और संपादक क्लासों का एक सेट समूहित करता है — PdfExtractor, PdfBookmarkEditor, PdfContentEditor, PdfAnnotationEditor, FormEditor, PdfFileEditor, और PdfConverter इनके बीच — Aspose::Pdf::Facades नेमस्पेस में। प्रत्येक एक कोर Document API के ऊपर एकल दस्तावेज़-रखरखाव कार्य को लपेटता है, जिससे आप सामग्री निकाल सकते हैं, बुकमार्क संपादित कर सकते हैं, या फ़ॉर्म फ़ील्ड भर सकते हैं बिना स्वयं नीचे की पेज और ऑब्जेक्ट वॉक्स को हाथ से लिखे। यह गाइड PdfExtractor पर केंद्रित है, वह फ़ेसाद जिसका उपयोग एम्बेडेड फ़ाइल अटैचमेंट्स, पेज टेक्स्ट, और एम्बेडेड इमेजेस को मौजूदा PDF से निकालने के लिए किया जाता है।

स्टेप-बाय-स्टेप गाइड

git clone https://github.com/aspose-pdf-foss/Aspose.PDF-FOSS-for-Cpp.git

add_subdirectory(Aspose.PDF-FOSS-for-Cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)

cmake -S . -B build
cmake --build build

#include <aspose/pdf/document.hpp>
#include <aspose/pdf/facades/pdf_extractor.hpp>

using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

Document doc("input.pdf");
PdfExtractor extractor(doc);

#include <iostream>

if (doc.EmbeddedFiles().Count() > 0) {
    std::vector<std::string> names = extractor.GetAttachNames();
    for (const auto& name : names) {
        std::cout << "Attachment: " << name << "\n";
    }

    // Writes the bytes of the first attachment to disk
    extractor.GetAttachment("extracted_attachment.bin");
}

extractor.ExtractText();
extractor.GetText("extracted_text.txt");

extractor.StartPage(1);
extractor.EndPage(doc.Pages().Count());

int pageNumber = extractor.StartPage();
while (extractor.HasNextPageText()) {
    std::string outputFile = "page_" + std::to_string(pageNumber) + ".txt";
    extractor.GetNextPageText(outputFile);
    ++pageNumber;
}

extractor.ExtractImage();

int imageIndex = 1;
while (extractor.HasNextImage()) {
    std::string outputFile = "extracted_image_" + std::to_string(imageIndex);
    if (extractor.GetNextImage(outputFile)) {
        ++imageIndex;
    }
}

आम समस्याएँ और समाधान

GetAttachNames() एक खाली वेक्टर वापस करता है। स्रोत PDF में कोई एम्बेडेड फ़ाइलें नहीं हैं। जाँच करें doc.EmbeddedFiles().Count() किसी भी अटैचमेंट मेथड को कॉल करने से पहले PdfExtractor ताकि आप ऐसे दस्तावेज़ से निकालने का प्रयास न करें जिसमें कभी अटैचमेंट नहीं थे।

पेज-टेक्स्ट लूप कभी बॉडी में प्रवेश नहीं करता। HasNextPageText() returns false तुरंत यदि StartPage() / EndPage() कभी सेट नहीं किए गए थे, या यदि उन्हें दस्तावेज़ की वास्तविक पृष्ठ गिनती के बाहर की रेंज पर सेट किया गया था। रेंज को स्पष्ट रूप से इस से सेट करें doc.Pages().Count() जाँचने से पहले HasNextPageText().

GetNextImage() returns false पहली कॉल पर। ExtractImage() जाँच करने से पहले इमेज कर्सर को प्राइम करने के लिए इसे एक बार कॉल किया जाना चाहिए HasNextImage() या कॉल करें GetNextImage(). कॉल करना GetNextImage() पहले के बिना ExtractImage() कॉल कॉलर के दृष्टिकोण से अपरिभाषित है — हमेशा कॉल करें ExtractImage() पहले।

प्रत्येक निकाला गया इमेज या पेज-टेक्स्ट फ़ाइल पिछले को ओवरराइट कर देती है। GetNextImage() and GetNextPageText() प्रत्येक एक वास्तविक आउटपुट पथ लेता है; फ़ेसाड आपके लिए अद्वितीय फ़ाइलनाम नहीं बनाता। प्रत्येक पुनरावृत्ति के लिए एक अलग पथ बनाएं (उदाहरण के लिए, एक बढ़ते काउंटर को जोड़कर) जैसा कि Steps 5 और 6 में दिखाया गया है।

लिंक त्रुटि: अपरिभाषित रेफ़रेंस टू aspose_pdf_foss symbols. Confirm add_subdirectory() क्लोन किए गए रिपॉजिटरी रूट की ओर संकेत करता है और वह target_link_libraries() नाम देता है aspose_pdf_foss टारगेट को ठीक-ठीक नाम देता है, C++20 मानक के साथ कॉन्फ़िगर किया गया your_app.

अक्सर पूछे जाने वाले प्रश्न

फ़ेसाड्स API और कोर डॉक्यूमेंट API में क्या अंतर है?

कोर Document API (Document, PageCollection, Annotation, आदि) PDF ऑब्जेक्ट मॉडल को सीधे उजागर करता है। PdfExtractor जैसी फ़ेसाड क्लासेस इसके ऊपर स्थित होती हैं और एक विशिष्ट बहु-चरणीय कार्य — सामग्री निकालना, बुकमार्क संपादित करना, फ़ॉर्म फ़ील्ड भरना — को एक संकीर्ण, उद्देश्य-निर्मित इंटरफ़ेस के पीछे पैकेज करती हैं।

क्या मैं PdfExtractor के साथ सामग्री निकालने की ही तरह बुकमार्क संपादित कर सकता हूँ या फ़ॉर्म फ़ील्ड भर सकता हूँ?

हाँ। PdfBookmarkEditor (CreateBookmarks(), ModifyBookmarks(), ExtractBookmarks(), और DeleteBookmarks() के साथ) और FormEditor (AddField(), RemoveField(), और SetFieldAttribute() के साथ) एक ही Aspose::Pdf::Facades नेमस्पेस में स्थित हैं और चरण 2 और 3 में दिखाए गए समान include/construct पैटर्न का पालन करते हैं — प्रत्येक दस्तावेज़ के अलग भाग पर काम करता है।

क्या PdfExtractor पासवर्ड-संरक्षित PDF को पढ़ सकता है?

किसी भी निष्कर्षण विधि को कॉल करने से पहले पासवर्ड सेट करें:

extractor.Password("owner-or-user-password");

PdfExtractor::Password() एक साधारण पढ़ने/लिखने वाली प्रॉपर्टी है, इसलिए इसे ExtractText(), ExtractImage() या अटैचमेंट मेथड्स से पहले सेट किया जाना चाहिए।

यदि PDF में निकालने के लिए कोई टेक्स्ट, इमेज या अटैचमेंट नहीं है तो क्या होता है?

कुछ भी एक्सेप्शन नहीं फेंकेगा। GetAttachNames() एक खाली वेक्टर रिटर्न करता है, और HasNextPageText() / HasNextImage() पहले चेक पर false रिटर्न करते हैं, इसलिए संबंधित लूप बॉडी कभी नहीं चलती।

किस फ़ेसाड क्लास के लिए मुझे कौन सा हेडर शामिल करना चाहिए?

प्रत्येक फ़ेसाड क्लास अपना हेडर aspose/pdf/facades/ के अंतर्गत प्रदान करती है, जो क्लास नाम से मेल खाता है: pdf_extractor.hpp PdfExtractor के लिए, pdf_bookmark_editor.hpp PdfBookmarkEditor के लिए, form_editor.hpp FormEditor के लिए, और bookmark.hpp Bookmark / Bookmarks वैल्यू टाइप्स के लिए।

यह भी देखें

• क्विक स्टार्ट — Aspose.PDF FOSS for C++
• Document, Page, और Rendering Fundamentals
• PdfExtractor क्लास रेफ़रेंस
• Aspose.PDF FOSS for C++ उत्पाद पृष्ठ
• Aspose.PDF for C++ — Enterprise Knowledge Base