Tcl

Attach a File to an Email

Demonstrates the Chilkat Email.AddFileAttachment method, which attaches a file read from the filesystem. It returns the content type Chilkat assigned to the attachment (inferred from the file extension). This example attaches a PDF and prints its detected content type.

Background: Each attachment carries a Content-Type (MIME type) such as application/pdf or image/png that tells the receiving client how to handle it. Chilkat gets this from the file's extension. Because attachment bytes are binary, they are Base64-encoded for transport, which is handled automatically — you simply point AddFileAttachment at a path and the file is read, encoded, and packaged into the message.

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

#  Demonstrates the AddFileAttachment method, which attaches a file read from the
#  filesystem.  It returns the content type Chilkat assigned to the attachment (based on
#  the file extension), or returns failure if the file could not be read.

set email [new_CkEmail]

CkEmail_put_Subject $email "Email with a file attachment"
CkEmail_put_Body $email "Please see the attached file."

#  Attach a file.  The return value is the auto-detected content type.
set contentType [CkEmail_addFileAttachment $email "qa_data/attachments/report.pdf"]
if {[CkEmail_get_LastMethodSuccess $email] == 0} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkEmail $email
    exit
}

puts "Attached content type = $contentType"
puts "NumAttachments = [CkEmail_get_NumAttachments $email]"

#  Note: The path "qa_data/attachments/report.pdf" is a relative local filesystem path,
#  relative to the current working directory of the running application.

delete_CkEmail $email