PowerBuilder

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 PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
oleobject loo_Email

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

loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")
if li_rc < 0 then
    destroy loo_Email
    MessageBox("Error","Connecting to COM object failed")
    return
end if
loo_Email.Subject = "Quarterly report"
loo_Email.From = "alice@example.com"
loo_Email.AddHeaderField("X-Priority","1")

//  Get header field values by name.
Write-Debug "Subject = " + loo_Email.GetHeaderField("Subject")
Write-Debug "From = " + loo_Email.GetHeaderField("From")
Write-Debug "X-Priority = " + loo_Email.GetHeaderField("x-priority")


destroy loo_Email