Xbase++

Get a Header Field by Name

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 Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL oEmail

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

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "Quarterly report"
oEmail:From := "alice@example.com"
oEmail:AddHeaderField("X-Priority", "1")

//  Get header field values by name.
? "Subject = " + oEmail:GetHeaderField("Subject")
? "From = " + oEmail:GetHeaderField("From")
? "X-Priority = " + oEmail:GetHeaderField("x-priority")

oEmail:destroy()