Як працювати з прикметниками в C++

Aspose.Email FOSS for C++ provides the mapi_attachment клас для створення додатків з нерозроблених байтів або потоків, а також mapi_message Список додатків для читання додаткових документів Ви можете додавати додатки при складанні повідомлень і оглядати їх. при завантаженні файлів, включаючи виявлення того, чи є додаток сам по собі вбудованим Повідомлення.

Крок 1 - Завантажити проект

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)

Крок 2 Додавати файл-прикладання з байтів

Використання mapi_message::add_attachment() прикладати двоякі дані під час складання повідомлення. Введіть ім’я файлу, сировини байтів як std::vector<std::uint8_t>, і MIME тип вмісту:

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

int main()
{
    auto message = aspose::email::foss::msg::mapi_message::create(
        "Report", "Please review the attached report.");
    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");

    // Attach a text file
    std::vector<std::uint8_t> text_data{'H', 'e', 'l', 'l', 'o'};
    message.add_attachment("notes.txt", text_data, "text/plain");

    // Attach a binary blob
    std::vector<std::uint8_t> bin_data{0x00, 0x01, 0x02, 0x03};
    message.add_attachment("data.bin", bin_data, "application/octet-stream");

    message.save(std::filesystem::path("report.msg"));
}

Крок 3 Додавати додаток з файлу на диске

Читайте файл у байт вектор, потім передавати його до add_attachment():

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

int main()
{
    // Read a file into bytes
    std::ifstream file("document.pdf", std::ios::binary);
    std::vector<std::uint8_t> pdf_bytes(
        std::istreambuf_iterator<char>(file),
        std::istreambuf_iterator<char>{});

    auto message = aspose::email::foss::msg::mapi_message::create(
        "Document", "See attached PDF.");
    message.set_sender_name("Alice");
    message.set_sender_email_address("alice@example.com");
    message.add_recipient("bob@example.com", "Bob");
    message.add_attachment("document.pdf", pdf_bytes, "application/pdf");

    message.save(std::filesystem::path("with_pdf.msg"));
}

Крок 4 Читання додатків з існуючих файлів MSG

message.attachments() повертає a const посилання на вектор об’єктів прикріплення. Кожна з них показує: filename, mime_type, data (невироблені байти) та content_id:

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

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

    std::cout << "Attachments: " << message.attachments().size() << '\n';
    for (std::size_t i = 0; i < message.attachments().size(); ++i)
    {
        const auto& a = message.attachments()[i];
        std::cout << "[" << (i + 1) << "]"
                  << "  name="         << a.filename
                  << "  mime="         << a.mime_type
                  << "  bytes="        << a.data.size()
                  << "  content_id="   << a.content_id
                  << '\n';
    }
}

Крок 5 Виявлення та доступ до вбудованих повідомлень

Деякі файли MSG містять інші файлі MSG як додатки (припрошення до перенаправлення або зустрічі). Використання is_embedded_message() для виявлення цих і доступу до вкладених повідомлень через embedded_message:

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

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

    for (const auto& attachment : message.attachments())
    {
        if (attachment.is_embedded_message() && attachment.embedded_message != nullptr)
        {
            const auto& inner = *attachment.embedded_message;
            std::cout << "Embedded subject: " << inner.subject() << '\n';
            std::cout << "Embedded from:    " << inner.sender_email_address() << '\n';

            // Save the embedded message as a standalone MSG
            inner.save(std::filesystem::path("embedded.msg"));
        }
        else
        {
            std::cout << "Regular attachment: " << attachment.filename
                      << " (" << attachment.data.size() << " bytes)\n";
        }
    }
}

Крок 6 Заховувати дані додатка на диск

Витягти байти додатку і записати їх у файл, використовуючи стандартні потоки файлів C++:

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

int main()
{
    const auto message = aspose::email::foss::msg::mapi_message::from_file(
        std::filesystem::path("sample.msg"));

    const std::filesystem::path out_dir("attachments");
    std::filesystem::create_directories(out_dir);

    for (const auto& a : message.attachments())
    {
        if (!a.is_embedded_message())
        {
            const auto out_path = out_dir / a.filename;
            std::ofstream out(out_path, std::ios::binary);
            out.write(reinterpret_cast<const char*>(a.data.data()),
                      static_cast<std::streamsize>(a.data.size()));
            std::cout << "Saved: " << out_path << '\n';
        }
    }
}

Загальні проблеми та рішення

attachment.data є порожнім для відомого великого прикмету. Перевірка джерела файлу MSG MSG файли експортовані з деяких Mail-клиенти можуть зберігати додатки як зовнішні посилання, які бібліотека не може слідувати.

is_embedded_message() повернення true але … embedded_message є: nullptr. У. заголовок додатка вказує на вбудований MSG, але дані не були аналізовані. Перевірте це джерело MSG є дійсним і не зрізаним.

Заховування витягнутого додатку не вдалося через помилку шляху. Деякі імена файлів додатків містить символи, які не є дійсними в цільовій файловій системі (наприклад,., :, ? на Дезинфекція. attachment.filename перед побудовою вихідного шляху.

Великі файли MSG викликають високий споживання пам’яті. Короткоmapi_message::from_file() завантаження всі Для великих файлів відкрийте базовий контейнер CFB з cfb_reader отримати доступ до окремих потоків без повної реалізації всіх прикмет.

add_attachment() не знайдено під час компіляції. Переконайтеся, що ви використовуєте правильний препарат. включають: "aspose/email/foss/msg/mapi_message.hpp".Метод є членом aspose::email::foss::msg::mapi_message.

Часто задавані запитання

Які MIME типи я повинен використовувати для додатків?

Використовуйте стандартний тип IANA MIME для формату файлу: "text/plain" для .txt, "application/pdf" для .pdf, "application/octet-stream" як загальний запасний варіант для: MIME тип зберігається як файл, що є двояким. attach_mime_tag MAPI власність.

Чи можу я прикріпляти один і той же файл кілька разів?

Кожна дзвінка до… add_attachment() додає незалежну записку. назви файлів дозволені; вони відрізняються за позицією в списку додатків.

Як встановити Content-ID для зображень в лінії?

Передайте струнку ID змісту як четвертий аргумент до: mapi_attachment::from_stream():

auto att = aspose::email::foss::msg::mapi_attachment::from_bytes(
    "logo.png", png_bytes, "image/png", "<logo-cid@example.com>");

content_id експонується як: attachment.content_id коли читає відповідь.

є `attachment.data` копію чи посилання?

attachment.data є std::vector<std::uint8_t> зберігання за вартістю всередині mapi_message Доступ до нього не викликає додаткових В/В.

Чи можна зняти прикріплення перед збереженням?

У. mapi_message API не показує метод прямого видалення-прикладання в версії 0.1.0. Build a new message, copy the desired properties and attachments manually, і зберегти новий об’єкт.