PureBasic

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

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

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

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "Attachment filename")

    CkEmail::ckAddStringAttachment(email,"notes.txt","Some notes.")

    ;  Get the filename of the first attachment (index 0).
    fname.s = CkEmail::ckGetAttachmentFilename(email,0)
    Debug "Attachment 0 filename: " + fname


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure