Aspose.Email FOSS za C++
Čitajte, stvarajte i obrađujte Outlook MSG datoteke i CFB kontejnere iz C++ — besplatno i otvorenog koda, bez ovisnosti o Microsoft Outlooku.
Open-Source C++ biblioteka za MSG i CFB datoteke
Aspose.Email FOSS za C++ je MIT-licencirana, open‑source C++ biblioteka za rad s Microsoft Outlook .msg datotekama i Compound File Binary (CFB) kontejnerima. Uključite zaglavlja putem CMake‑a i odmah počnite čitati, stvarati i obrađivati e‑mail poruke bez instalacije Microsoft Outlooka ili bilo kojeg vlasničkog runtime‑a.
Biblioteka pruža dvije razine pristupa. Na niskoj razini, cfb_reader i cfb_writer daju potpunu kontrolu nad CFB binarnim kontejnerima — prolazak kroz unose direktorija, čitanje i pisanje čvorova pohrane i podataka tokova, te pregled sirovog rasporeda sektora. msg_reader i msg_writer obrađuju MSG format na vrhu CFB‑a, izlažući MAPI tokove svojstava, tablice primatelja i pod‑pohrane privitaka. Na visokoj razini, mapi_message vam omogućuje stvaranje novih poruka od nule, čitanje naslova, tijela, primatelja i privitaka, te konverziju između MSG i EML formata.
Biblioteka se može izgraditi na bilo kojoj platformi s C++17 kompajlerom i nema vanjske ovisnosti, što je čini prikladnom za Windows, Linux, macOS, Docker kontejnere i ugrađene sustave.
CFB Container Read and Write
- Open CFB files: Load existing CFB containers from a file path, stream, or byte array via
cfb_reader::from_file(),cfb_reader::from_stream(), orcfb_reader::from_bytes(). - Traverse the directory tree: Enumerate storages and streams using
storage_ids(),stream_ids(), andchild_ids(), and navigate nested hierarchies withresolve_path(). - Inspect nodes: Check node type with
cfb_node::is_storage()andcfb_node::is_stream(), read timestamps viacreation_time()andmodified_time(). - Write CFB containers: Build CFB documents programmatically with
cfb_documentand serialize to bytes or file viacfb_writer::to_bytes()orcfb_writer::write_file().
Where CFB Access Is Used
- MSG file inspection: CFB is the container format for Outlook
.msgfiles — direct CFB access enables forensic inspection and repair. - Custom binary formats: Any legacy application using CFB for data storage can be read or written without a COM dependency.
- Data recovery: Traverse the full directory tree and extract raw stream bytes from damaged or non-standard CFB files.
MSG File Read and Write
- Read MSG files: Open Outlook MSG files with
msg_reader::from_file()ormsg_reader::from_stream()and access the underlying MAPI property streams and attachment sub-storages. - Write MSG files: Produce MSG files from a
msg_documentwithmsg_writer::to_bytes()ormsg_writer::write_file(). - MSG document inspection: Access version metadata via
msg_document::major_version(),msg_document::minor_version(), and check strictness withmsg_document::strict(). - Convert to CFB: Extract the underlying CFB document from an MSG file via
msg_document::to_cfb_document().
Where MSG Processing Is Used
- Email archival pipelines: Bulk-read
.msgfiles from archive directories and extract metadata or attachments. - Migration tools: Convert MSG collections to standard formats for import into non-Outlook systems.
- Legal discovery: Parse raw MAPI property streams to extract all message fields including non-standard properties.
High-Level MAPI Message API
- Create messages: Build a complete email with
mapi_message::create(), then set subject, body, and HTML body viaset_subject(),set_body(), andset_html_body(). - Set sender details: Configure
set_sender_name(),set_sender_email_address(), andset_sender_address_type()for the outgoing message. - Manage attachments: Load attachments from bytes or streams with
mapi_attachment::from_bytes()andmapi_attachment::from_stream(), and check for embedded messages viais_embedded_message(). - Save and reload: Serialize with
mapi_message::save()and reload withmapi_message::from_file()ormapi_message::from_stream().
Where the High-Level API Is Used
- Automated email generation: Generate thousands of personalized MSG files from data records in batch jobs.
- Test fixture creation: Build known-good MSG files with predictable content for integration test suites.
- Attachment extraction: Load an MSG file, iterate attachments, and save each to disk.
EML and MIME Conversion
- Load EML into mapi_message: Parse a standard
.emlfile (RFC 5322 / MIME) into a fullmapi_messageobject viamapi_message::load_from_eml(). - Save mapi_message as EML: Serialize a
mapi_messageback to MIME format withsave_to_eml(). - Round-trip fidelity: Subject, body, sender, recipients, and attachments are preserved through EML to MSG to EML round-trips.
Where EML Conversion Is Used
- Format bridging: Receive emails as EML from mail servers and convert to MSG for Outlook-compatible storage.
- Standards compliance: Convert proprietary MSG files to standard MIME for delivery to any mail transport.
- Archival normalization: Normalize a mixed archive of
.emland.msgfiles to a single format.
Read Subject from an MSG File
Open an Outlook MSG file from a stream and print the subject — no Microsoft Outlook required.
#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 << message.subject() << '\n';
}
Create and Save an MSG Message
Build a complete email with sender, recipient, and attachment, then write it to both MSG and EML formats.
#include <fstream>
#include "aspose/email/foss/msg/mapi_message.hpp"
int main()
{
auto message = aspose::email::foss::msg::mapi_message::create("Hello", "Body");
message.set_sender_name("Alice");
message.set_sender_email_address("alice@example.com");
message.add_recipient("bob@example.com", "Bob");
message.add_attachment("note.txt", std::vector<std::uint8_t>{'a', 'b', 'c'}, "text/plain");
std::ofstream msg_output("hello.msg", std::ios::binary);
message.save(msg_output);
std::ofstream eml_output("hello.eml", std::ios::binary);
message.save_to_eml(eml_output);
}
