PureBasic

Get the text body content of a MIME part.

See more MIME Examples

Explains and demonstrates the GetBodyEncoded and GetBodyDecoded methods. This example uses the MIME test data located at http://www.chilkatsoft.com/testData/sampleMime1.txt

The sampleMime1.txt contains:

Content-Type: multipart/mixed;
 boundary="------------070404010201060604000708";

This is a multi-part message in MIME format.

--------------070404010201060604000708
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; charset="utf-8";

Falsches =C3=9Cben von Xylophonmusik qu=C3=A4lt jeden gr=C3=B6=C3=9Feren Zwe=
rg.
--------------070404010201060604000708
Content-Transfer-Encoding: base64
Content-Type: text/plain; charset="utf-8";

RmFsc2NoZXMgw5xiZW4gdm9uIFh5bG9waG9ubXVzaWsgcXXDpGx0IGplZGVuIGdyw7bDn2VyZW4g
Wndlcmcu

--------------070404010201060604000708
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="iso-8859-1";

Falsches Üben von Xylophonmusik quält jeden größeren Zwerg.
--------------070404010201060604000708--

PureBasic

IncludeFile "CkMime.pb"

Procedure ChilkatExample()

    success.i = 0

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

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

    ; Load the sampleMime1.txt file into the MIME object.
    ; (This file is available at http://www.chilkatsoft.com/testData/sampleMime1.txt )

    success = CkMime::ckLoadMimeFile(mime,"sampleMime1.txt")
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        ProcedureReturn
    EndIf

    ; The sampleMime1.txt is a MIME document with a top-level 
    ; multipart/mixed containing 3 sub-parts, each of which has the 
    ; same body text but with different content-transfer-encodings and 
    ; using different character encodings (utf-8 and iso-8859-1).

    ; Calling mime.GetBodyEncoded or mime.GetBodyDecoded on the 
    ; top-level multipart/mixed MIME object will return an empty string.
    ; It is because the "body" of a multipart MIME object is always empty.
    ; A multipart MIME object contains sub-parts (each a MIME object),
    ; and it is only the leaf-objects that can have non-empty bodies.

    ; Get GetBodyDecoded method returns the body text decoded
    ; from whatever the content-transfer-encoding may be, and
    ; converted from whatever charset encoding might be used.
    ; In this case, calling GetBodyDecoded on each of the three
    ; sub-parts will return the same string.
    ; To demonstrate:
    part1.i = CkMime::ckCreate()
    If part1.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkMime::ckPartAt(mime,0,part1)
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        CkMime::ckDispose(part1)
        ProcedureReturn
    EndIf

    Debug CkMime::ckGetBodyDecoded(part1)

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

    success = CkMime::ckPartAt(mime,1,part2)
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        CkMime::ckDispose(part1)
        CkMime::ckDispose(part2)
        ProcedureReturn
    EndIf

    Debug CkMime::ckGetBodyDecoded(part2)

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

    success = CkMime::ckPartAt(mime,2,part3)
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        CkMime::ckDispose(part1)
        CkMime::ckDispose(part2)
        CkMime::ckDispose(part3)
        ProcedureReturn
    EndIf

    Debug CkMime::ckGetBodyDecoded(part3)

    ; The GetBodyEncoded method will NOT decode from 
    ; whatever content-transfer-encoding is used.  However, it will
    ; convert from whatever internal character encoding
    ; may be used to return a string appropriate for the calling
    ; programming language (for example, in .NET or any language
    ; using ActiveX, all strings are Unicode..)
    Debug CkMime::ckGetBodyEncoded(part1)
    Debug CkMime::ckGetBodyEncoded(part2)
    Debug CkMime::ckGetBodyEncoded(part3)


    CkMime::ckDispose(mime)
    CkMime::ckDispose(part1)
    CkMime::ckDispose(part2)
    CkMime::ckDispose(part3)


    ProcedureReturn
EndProcedure