Hur man börjar med Aspose.Email FOSS för C++

Aspose.Email FOSS for C++ is a library for reading and writing Outlook MSG files, EML messages, and CFB containers. It has no third-party dependencies and requires only a C++17 compiler and CMake.

git clone https://github.com/aspose-email-foss/Aspose.Email-FOSS-for-Cpp.git

add_subdirectory(Aspose.Email-FOSS-for-Cpp)
target_link_libraries(your_target PRIVATE AsposeEmailFoss::AsposeEmailFoss)

#include <fstream>
#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"

int main()
{
    std::ifstream input("sample.msg", std::ios::binary);
    auto message = aspose::email::foss::msg::mapi_message::from_stream(input);

    std::cout << "Subject: " << message.subject() << '\n';
    std::cout << "From: "    << message.sender_email_address() << '\n';
    std::cout << "Body: "    << message.body() << '\n';

    for (const auto& recipient : message.recipients())
        std::cout << "To: " << recipient.email_address << '\n';

    for (const auto& attachment : message.attachments())
        std::cout << "Attachment: " << attachment.filename
                  << " (" << attachment.mime_type << ")\n";
}

#include <fstream>
#include "aspose/email/foss/msg/mapi_message.hpp"

int main()
{
    auto message = aspose::email::foss::msg::mapi_message::create(
        "Meeting Notes", "Please find the agenda attached.");

    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");
    message.add_attachment(
        "agenda.txt",
        std::vector<std::uint8_t>{'I', 't', 'e', 'm', ' ', '1'},
        "text/plain");

    std::ofstream output("meeting_notes.msg", std::ios::binary);
    message.save(output);
}

#include <filesystem>
#include <iostream>
#include "aspose/email/foss/msg/mapi_message.hpp"

int main()
{
    // EML → MSG
    auto message = aspose::email::foss::msg::mapi_message::load_from_eml(
        std::filesystem::path("message.eml"));

    std::cout << "Subject: " << message.subject() << '\n';
    message.save(std::filesystem::path("converted.msg"));

    // MSG → EML round-trip
    auto loaded = aspose::email::foss::msg::mapi_message::from_file(
        std::filesystem::path("converted.msg"));
    loaded.save_to_eml(std::filesystem::path("roundtrip.eml"));

    std::cout << "Saved converted.msg and roundtrip.eml\n";
}

Vanliga problem och fixar

Binärläge inte inställd på strömmen. Öppna en fil med std::ifstream input("file.msg") utan std::ios::binary kan orsaka Windows-linjeändaröversättning som korrupterar CFB Hållare Pass std::ios::binary För både input och output strömmar.

Linkor fel: AsposeEmailFoss::AsposeEmailFoss inte hittat. Kontrollera att det add_subdirectory(Aspose.Email-FOSS-for-Cpp) förekommer innan target_link_libraries(...) I din CMakeLists.txt,och det underordnade namnet på matchar klonade mappar exakt.

C++17 är inte aktiverad. Biblioteket kräver C++17-funktioner. om kompileraren rapporterar fel om strukturerade band eller std::filesystem,och add set(CMAKE_CXX_STANDARD 17) I den Topp av din CMakeLists.txt Innan den add_subdirectory och ringa.

tomt ämne eller kropp efter läsning. Vissa MSG-filer lagrar text i Unicode-egenskaper medan andra använder ANSI kod-sidor. message.subject() och message.body() returnerar strängen från vilken lagring som helst är närvarande; kontrollera message.html_body() Om message.body() är tomt.

load_from_eml Hämta på skadad EML. Kontrollera att EML-filen använder RFC 5322 linjeändar (CRLF) och har giltiga MIME-högtalare. biblioteket hoppar inte tyst Förfalskade huvudrutor.

Ofta ställda frågor

Behöver biblioteket Microsoft Outlook eller någon COM-komponent?

Aspose.Email FOSS för C++ använder sin egen CFB och MAPI parser och har inga tredjepartsberoende. Det fungerar på Linux, macOS och Windows utan Outlook installerat.

Vilka format kan jag läsa och skriva?

MSG (Outlook Message), EML (RFC 5322 / MIME) och CFB (Compound File Binary) stöds för både läsning och skrivande. TNEF (winmail.dat), IMAP, SMTP och POP3 stödas inte.

Hur sparar jag ett meddelande till byter istället för en fil?

Ringa till save() eller save_to_eml() Ingen argument. båda återvänder std::vector<std::uint8_t>, som du kan skriva till någon buffer eller ström.

Vilken C++ standard krävs?

C++17: Biblioteket använder std::filesystem, std::optional,och andra C++17 GCC 9+, Clang 10+ och MSVC 2019+ listas som stöds i Projektet är readme.

Finns det en paketmanager release (vcpkg, Conan)?

Version 0.1.0 distribueras endast via källkod. klona lagret och använd add_subdirectory som anges ovan. pakethanteraren manifester kan läggas till i framtiden släpps ut.

Se även

• FAQ — Aspose.Email FOSS för C++
• Hur man läser MSG-filer i C++
• Hur man konverterar EML till MSG i C++
• Aspose.Email FOSS for C++ on GitHub