Sample code for 30+ languages & platforms
Tcl

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

Tcl

load ./chilkat.dll

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

set email [new_CkEmail]

CkEmail_put_Subject $email "Quarterly report"
CkEmail_put_From $email "alice@example.com"
CkEmail_AddHeaderField $email "X-Priority" "1"

#  Get header field values by name.
puts "Subject = [CkEmail_getHeaderField $email Subject]"
puts "From = [CkEmail_getHeaderField $email From]"
puts "X-Priority = [CkEmail_getHeaderField $email x-priority]"

delete_CkEmail $email