PureBasic

Get a Bcc Recipient's Name Only

Demonstrates the Chilkat Email.GetBccName method, which returns only the friendly-name part (not the address) of the Nth blind carbon-copy recipient. The index is zero-based. This example adds two Bcc recipients and prints each one's display name.

Background: The display name is the human-friendly label attached to an address, like Joe Smith for joe@example.com. It is optional and purely cosmetic, but useful for presentation — for instance rendering "Joe Smith" in a UI instead of the raw address. GetBccName returns just that name; if a recipient was added without one, the result is empty.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    ;  Demonstrates the GetBccName method, which returns only the friendly-name part (not the
    ;  address) of the Nth blind carbon-copy recipient.  The index is zero-based.

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

    CkEmail::setCkSubject(email, "GetBccName example")

    CkEmail::ckAddBcc(email,"Joe Smith","joe@example.com")
    CkEmail::ckAddBcc(email,"Jane Doe","jane@example.com")

    n.i = CkEmail::ckNumBcc(email)
    i.i
    For i = 0 To n - 1
        Debug "Bcc " + Str(i) + " name: " + CkEmail::ckGetBccName(email,i)
    Next


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure