PureBasic

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

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    ;  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.

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

    CkEmail::setCkSubject(email, "Email with a file attachment")
    CkEmail::setCkBody(email, "Please see the attached file.")

    ;  Attach a file.  The return value is the auto-detected content type.
    contentType.s = CkEmail::ckAddFileAttachment(email,"qa_data/attachments/report.pdf")
    If CkEmail::ckLastMethodSuccess(email) = 0
        Debug CkEmail::ckLastErrorText(email)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    Debug "Attached content type = " + contentType
    Debug "NumAttachments = " + Str(CkEmail::ckNumAttachments(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.


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure