PHP ActiveX

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 PHP ActiveX Downloads

Download Chilkat for PHP ActiveX

PHP ActiveX

<?php

$success = 0;

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

$msgSet = new COM("Chilkat.MessageSet");

//  Start with messages 1 through 10.
$success = $msgSet->FromCompactString('1:10');
if ($success == 0) {
    print $msgSet->LastErrorText . "\n";
    exit;
}

//  The identifiers that have already been processed and should be excluded.
$processed = new COM("Chilkat.MessageSet");
$success = $processed->FromCompactString('2,4,6');
if ($success == 0) {
    print $processed->LastErrorText . "\n";
    exit;
}

//  Remove the already-processed identifiers from msgSet.
$msgSet->Subtract($processed);

//  Show what remains.
$remaining = $msgSet->toCompactString();
print $remaining . "\n";
//  Output: 1,3,5,7:10

?>