Lianja

Subtract One MessageSet from Another

Demonstrates the Chilkat MessageSet.Subtract method, which removes from this set every identifier whose numeric value is also present in another MessageSet. The only argument is the other set. This example starts with ids 1:10, subtracts 2,4,6, and prints what remains.

Background: A common IMAP pattern is "process everything except what I've already handled." Subtract makes that a single call: remove the already-processed ids from a working set. The comparison is numeric only and this object's HasUids is preserved, so for meaningful results both sets should hold the same id type from the same mailbox. Passing the same object clears the set; passing an empty set changes nothing.

Chilkat Lianja Downloads

Download Chilkat for Lianja

Lianja

llSuccess = .F.

//  Demonstrates the MessageSet.Subtract method, which removes from this set every identifier
//  that is also present in another MessageSet.  The only argument is the other MessageSet.

loMsgSet = createobject("CkMessageSet")

//  Start with messages 1 through 10.
llSuccess = loMsgSet.FromCompactString("1:10")
if (llSuccess = .F.) then
    ? loMsgSet.LastErrorText
    release loMsgSet
    return
endif

//  The identifiers that have already been processed and should be excluded.
loProcessed = createobject("CkMessageSet")
llSuccess = loProcessed.FromCompactString("2,4,6")
if (llSuccess = .F.) then
    ? loProcessed.LastErrorText
    release loMsgSet
    release loProcessed
    return
endif

//  Remove the already-processed identifiers from msgSet.
loMsgSet.Subtract(loProcessed)

//  Show what remains.
lcRemaining = loMsgSet.ToCompactString()
? lcRemaining
//  Output: 1,3,5,7:10


release loMsgSet
release loProcessed