BRLOptionParser 0.3.1

BRLOptionParser 0.3.1

LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Sep 2015

Maintained by Stephen Celis.

  • By
  • Stephen Celis

A short wrapper for getopt_long(3) (and getopt_long_only(3)).


With CocoaPods:

# Podfile
pod 'BRLOptionParser', '~> 0.3.1'


// main.m
#import <BRLOptionParser/BRLOptionParser.h>

int main(int argc, const char * argv[])
    @autoreleasepool {
        NSString *name = @"world";
        BOOL verbose = NO;

        BRLOptionParser *options = [BRLOptionParser new];

        [options setBanner:@"usage: %s [-n <name>] [-vh]", argv[0]];
        [options addOption:"name" flag:'n' description:@"Your name" argument:&name];
        [options addSeparator];
        [options addOption:"verbose" flag:'v' description:nil value:&verbose];
        __weak typeof(options) weakOptions = options;
        [options addOption:"help" flag:'h' description:@"Show this message" block:^{
            printf("%s", [[weakOptions description] UTF8String]);

        NSError *error = nil;
        if (![options parseArgc:argc argv:argv error:&error]) {
            const char * message = error.localizedDescription.UTF8String;
            fprintf(stderr, "%s: %s\n", argv[0], message);

        if (verbose) {
            fprintf(stderr, "(Preparing to say hello...)\n");

        printf("Hello, %s!\n", name.UTF8String);

    return EXIT_SUCCESS;

In practice:

$ hello
Hello, world!
$ hello -h
usage: hello [-n <name>] [-vh]
    -n, --name                       Your name

    -v, --verbose
    -h, --help                       Show this message
$ hello -n
hello: option `-n' requires an argument
$ hello --name Stephen
Hello, Stephen!
$ hello -vngoodbye
(Preparing to say hello...)
Hello, goodbye!
$ hello --goodbye
hello: unrecognized option `--goodbye'


BRLOptionParser is available under the MIT license. See the LICENSE file for more information.