Hur man laddar ett dokument i C++

Aspose.PDF FOSS för C++ öppnar en befintlig PDF via Document-klassen — från en enkel filsökväg, eller med ett lösenord när källan är krypterad — och exponerar filens /Info-metadata via DocumentInfo. Denna guide täcker inläsning av ett dokument, upptäckt och öppning av lösenordsskyddade filer, läsning och uppdatering av titel/author/producer-metadata, och sparande av resultatet. Biblioteket läggs till i ett projekt via CMake; det finns inget installationssteg med paket-hanterare.

Steg-för-steg-guide

add_subdirectory(aspose.pdf-foss-for-cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)

#include <aspose/pdf/document.hpp>
#include <iostream>

int main() {
    Aspose::Pdf::Document doc;
    std::cout << "Linked OK — pages: " << doc.Pages().Count() << "\n";
}

#include <aspose/pdf/document.hpp>
#include <aspose/pdf/document_info.hpp>

using namespace Aspose::Pdf;

#include <iostream>
#include <stdexcept>

try {
    Document doc("input.pdf");
    std::cout << "Pages: " << doc.Pages().Count() << "\n";
} catch (const std::runtime_error& e) {
    std::cerr << "Not a valid PDF: " << e.what() << "\n";
} catch (const std::system_error& e) {
    std::cerr << "Could not read file: " << e.what() << "\n";
}

try {
    Document doc("input.pdf", "user-password");
    if (doc.IsEncrypted()) {
        std::cout << "Opened an encrypted document.\n";
    }
} catch (const std::runtime_error& e) {
    // Thrown when /Encrypt is present and the password matches
    // neither the user nor the owner entry in the trailer.
    std::cerr << "Wrong password or unreadable /Encrypt dictionary: "
              << e.what() << "\n";
}

Document doc("input.pdf");
DocumentInfo& info = doc.Info();

std::cout << "Title: "    << info.Title()    << "\n";
std::cout << "Author: "   << info.Author()   << "\n";
std::cout << "Subject: "  << info.Subject()  << "\n";
std::cout << "Producer: " << info.Producer() << "\n";
std::cout << "Creator: "  << info.Creator()  << "\n";
std::cout << "Keywords: " << info.Keywords() << "\n";

bool builtin = DocumentInfo::IsPredefinedKey("Title");   // true
bool custom  = DocumentInfo::IsPredefinedKey("MyKey");   // false

Document doc("input.pdf");
doc.Info().Author("Report Generator");
doc.SetTitle("Quarterly Report");   // equivalent to doc.Info().Title(title)

doc.Save("output.pdf");

Document doc("input.pdf");
doc.SetTitle("Updated In Place");
doc.Save();   // writes back to "input.pdf"

Vanliga problem och lösningar

IsEncrypted() returns false för en PDF som jag vet är lösenordsskyddad

Den enkla-argument Document(path)-konstruktorn autentiserar aldrig mot filens /Encrypt-lexikon, så IsEncrypted() rapporterar alltid false på ett dokument som öppnas på detta sätt, oavsett om källan faktiskt är krypterad. Öppna filen med den två-argument Document(path, password)-konstruktorn istället — den är den enda överlagringen som fyller i krypteringsstatusen.

Den två-argumentskonstruktorn kastar std::runtime_error

Detta betyder att käll-PDF:en har en /Encrypt-post i sin trailer och det angivna lösenordet matchade varken användar- eller ägarlösenordet som är lagrat där. Fånga std::runtime_error och be om rätt lösenord, eller bekräfta lösenordet utanför kanalen innan du försöker igen.

Save() kastar “no source filename to save to”

Den utan-argument Save() skriver tillbaka till sökvägen som ett dokument konstruerades från. En Document skapad med utan-argument-konstruktorn — ett färskt, minnes-dokument utan källfil — har ingen sökväg att skriva tillbaka till, så Save() kastar. Anropa Save(outputFileName) istället.

Decrypt() verkar inte producera en oskyddad fil

Decrypt() rensar den minnes-IsEncrypted()-flaggan så att efterföljande läsningar behandlar dokumentet som klartext, men i den nuvarande versionen skriver den inte om trailerens /Encrypt-lexikon eller återkodar krypterade strängar och strömmar. Ett Save()-anrop efter Decrypt() skriver fortfarande tillbaka de ursprungliga byten, inklusive den ursprungliga krypteringen — den här metoden producerar ännu inte en klartextkopia på disken.

Titel/Författare/etc. skrivs ut som tomma strängar

DocumentInfo accessors returnerar en tom sträng, inte ett fel, när motsvarande /Info nyckel saknas i käll-PDF-filen. Ett tomt resultat betyder att fältet aldrig har satts i det dokumentet, inte att läsningen misslyckades.

Vanliga frågor

Fungerar Document(path) på en krypterad PDF?

Den analyserar vanligtvis sidträdet utan att kasta ett undantag, men den autentiserar aldrig ett lösenord och lämnar alltid IsEncrypted() på false. Använd two-argument constructor när källan eventuellt kan vara krypterad.

Är det säkert att skicka ett lösenord till Document(path, password) för en fil som visar sig inte vara krypterad?

Ja. När trailern har ingen /Encrypt-post ignoreras lösenordsargumentet och dokumentet öppnas på samma sätt som med single-argument constructor.

Hur kan jag skilja en anpassad /Info-nyckel från en inbyggd?

Anropa den statiska DocumentInfo::IsPredefinedKey(key). Den returnerar true för Title, Author, Subject, Keywords, Creator, Producer och Trapped, och false för allt annat.

Kan jag skriva över filen jag just laddade istället för att skriva till en ny sökväg?

Ja — anropa den argumentlösa Save() på en Document som konstruerades från en filsökväg; den skriver tillbaka till samma källsökväg. Den kastar ett undantag för dokument som byggts med den argumentlösa konstruktorn, vilka saknar källsökväg.

Tar sparande efter Decrypt() bort PDF:ens lösenordsskydd?

Nej, inte i den aktuella versionen — se Vanliga problem ovan. Decrypt() påverkar endast minnesstatus som används av innehållsläsare; filen som skrivs av Save() behåller fortfarande den ursprungliga /Encrypt-ordboken.

Se även

• Dokument, Sida och Återgivning Grundläggande (Utvecklare Guide)
• Installationsguide
• API Reference
• GitHub-arkiv
• Aspose.PDF for C++ — Enterprise Knowledge Base