Rust

Remove a Header Field from an Email

Demonstrates the Chilkat Email.RemoveHeaderField method, which removes by name all occurrences of a header field. Header-field names are case-insensitive, and every repeated occurrence with the given name is removed. This example adds a custom header, then removes it.

Background: Editing a message sometimes means deleting a header outright — stripping a tracking header, removing an X- flag before forwarding, or clearing a stale field before re-sending. Because a field name can appear more than once (like Received), RemoveHeaderField removes all matching occurrences in one call rather than just the first.

Chilkat Rust Downloads

Download Chilkat for Rust

Rust

// Demonstrates the RemoveHeaderField method, which removes by name all occurrences of a
// header field.  Header-field names are case-insensitive.

let email = chilkat::Email::new();
email.set_subject("Remove header field");
email.set_from("alice@example.com");

email.add_header_field("X-Custom-Header", "some value");

// Use HasHeaderMatching to test for the header's presence.  ("*" matches any value.)
let has_before = email.has_header_matching("X-Custom-Header", "*", false);
println!("Has X-Custom-Header before: {}", has_before);

// Remove all occurrences of the header field.
email.remove_header_field("X-Custom-Header");

let has_after = email.has_header_matching("X-Custom-Header", "*", false);
println!("Has X-Custom-Header after: {}", has_after);