PowerBuilder

Load a MessageSet from a Compact String

Demonstrates the Chilkat MessageSet.FromCompactString method, which clears the set and loads message identifiers from compact IMAP message-set syntax. The only argument is the compact string: a colon specifies an inclusive ascending range, and commas separate values or ranges. This example loads 1:5,8:10 and prints the result as a comma-separated list.

Background: Compact message-set syntax is how IMAP itself expresses groups of messages — 1:5,8:10 is far more concise than listing every id. FromCompactString is the inverse of ToCompactString: it parses that text into a set you can pass to Imap methods. Duplicates are removed, identifiers are sorted ascending, and the existing HasUids setting is preserved. Note the string carries only the numbers — it does not record whether they are UIDs or sequence numbers.

Chilkat PowerBuilder Downloads

Download Chilkat for PowerBuilder

PowerBuilder

integer li_rc
integer li_Success
oleobject loo_MsgSet
string ls_Csv

li_Success = 0

//  Demonstrates the MessageSet.FromCompactString method, which loads a set of message
//  identifiers from compact IMAP message-set syntax.  The only argument is the compact string.
//  A colon specifies an inclusive range, and commas separate values or ranges.

loo_MsgSet = create oleobject
li_rc = loo_MsgSet.ConnectToNewObject("Chilkat.MessageSet")
if li_rc < 0 then
    destroy loo_MsgSet
    MessageBox("Error","Connecting to COM object failed")
    return
end if

//  Load a compact message set.  "1:5,8:10" expands to 1,2,3,4,5,8,9,10.
li_Success = loo_MsgSet.FromCompactString("1:5,8:10")
if li_Success = 0 then
    Write-Debug loo_MsgSet.LastErrorText
    destroy loo_MsgSet
    return
end if

Write-Debug "Count: " + string(loo_MsgSet.Count)

//  Show the loaded identifiers in comma-separated form.
ls_Csv = loo_MsgSet.ToCommaSeparatedStr()
Write-Debug ls_Csv


destroy loo_MsgSet