Java

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 Java Downloads

Download Chilkat for Java

Java

import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

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

    CkMessageSet msgSet = new CkMessageSet();

    //  Load a compact message set.  "1:5,8:10" expands to 1,2,3,4,5,8,9,10.
    success = msgSet.FromCompactString("1:5,8:10");
    if (success == false) {
        System.out.println(msgSet.lastErrorText());
        return;
        }

    System.out.println("Count: " + msgSet.get_Count());

    //  Show the loaded identifiers in comma-separated form.
    String csv = msgSet.toCommaSeparatedStr();
    System.out.println(csv);
  }
}