Sample code for 30+ languages & platforms
Lua

Get a Header Field by Name

See more Email Object Examples

Demonstrates the Chilkat Email.GetHeaderField method, which returns the value of a header field by name. Header-field names are case-insensitive, so X-Priority and x-priority refer to the same field. This example reads several headers by name.

Background: Looking up a header by name is the quickest way to read a known field like Subject or a custom X- header. One caveat: some header names (such as Received) can legitimately appear more than once. When a field may repeat and you need every occurrence, enumerate by index with GetHeaderFieldName and GetHeaderFieldValue instead of looking up by name.

Chilkat Lua Downloads

Lua
local chilkat = require("chilkat")

-- Demonstrates the GetHeaderField method, which returns the value of a header field by
-- name.  Header-field names are case-insensitive.

local email = chilkat.Email.new()
email.subject = "Quarterly report"
email.from = "alice@example.com"
email:add_header_field("X-Priority", "1")

-- Get header field values by name.
print("Subject = " .. email:get_header_field("Subject"))
print("From = " .. email:get_header_field("From"))
print("X-Priority = " .. email:get_header_field("x-priority"))