Xbase++

Get the Filename of an Attachment

Demonstrates the Chilkat Email.GetAttachmentFilename method, which retrieves an attachment's filename as stored in the MIME. The index is zero-based. This example adds an attachment and reads its filename.

Background: An attachment's filename comes from the sender's message and is not guaranteed to be safe or unique — it may include path separators or characters that are awkward on the local filesystem, and two attachments can share a name. When saving attachments to disk, treat this value as untrusted input: sanitize it and guard against collisions (see the OverwriteExisting property, which can auto-generate unique names).

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL oEmail
LOCAL cFname

//  Demonstrates the GetAttachmentFilename method, which retrieves an attachment's filename
//  (as stored in the MIME).  The index is zero-based.

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "Attachment filename"

oEmail:AddStringAttachment("notes.txt", "Some notes.")

//  Get the filename of the first attachment (index 0).
cFname := oEmail:GetAttachmentFilename(0)
? "Attachment 0 filename: " + cFname

oEmail:destroy()