Sample code for 30+ languages & platforms
Objective-C

IMAP Capability

Demonstrates how to send the CAPABILITY command to request a listing of capabilities that the IMAP server supports. A capability name which begins with "AUTH=" indicates that the server supports that particular authentication mechanism.

Chilkat Objective-C Downloads

Objective-C
#import <CkoImap.h>
#import <NSString.h>

BOOL success = NO;

//  This example assumes the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

CkoImap *imap = [[CkoImap alloc] init];

//  Use TLS
imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];
success = [imap Connect: @"MY-IMAP-DOMAIN"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Authenticate
success = [imap Login: @"MY-IMAP-LOGIN" password: @"MY-IMAP-PASSWORD"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Get the list of capabilities:
NSString *caps = [imap Capability];
NSLog(@"%@%@",@"Capabilities: ",caps);

//  Here is an example of the string returned:
//  * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN X-GM-EXT-1 
//  UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT APPENDLIMIT=35882577
//  LIST-EXTENDED LIST-STATUS

//  Chilkat v9.5.0.58 introduces the HasCapability method to
//  check to see if a particular capability exists:
if ([imap HasCapability: @"QUOTA" capabilityResponse: caps] == YES) {
    NSLog(@"%@",@"IMAP server supports the QUOTA extension.");
}

if ([imap HasCapability: @"IDLE" capabilityResponse: caps] == YES) {
    NSLog(@"%@",@"IMAP server supports IDLE.");
}

//  Disconnect from the IMAP server.
success = [imap Disconnect];