CommandLineFlags Class Reference

#include <CommandLineFlags.h>

Classes
class	StringArray

Static Public Member Functions
static void	SetUsage (const char *usage)
static void	PrintUsage ()
static void	Parse (int argc, const char *const *argv)
static bool	ShouldSkip (const SkTDArray< const char * > &strings, const char *name)
static bool	ShouldSkip (const StringArray &strings, const char *name)

Friends
class	SkFlagInfo

Detailed Description

Definition at line 104 of file CommandLineFlags.h.

Member Function Documentation

Parse()

void CommandLineFlags::Parse ( int  argc, const char *const *  argv  )

static

Call at the beginning of main to parse flags created by DEFINE_x, above. Must only be called once.

Definition at line 215 of file CommandLineFlags.cpp.

                                                              {
    // Only allow calling this function once.
    static bool gOnce;
    if (gOnce) {
        SkDebugf("Parse should only be called once at the beginning of main!\n");
        SkASSERT(false);
        return;
    }
    gOnce = true;
 
    bool helpPrinted  = false;
    bool flagsPrinted = false;
    // Loop over argv, starting with 1, since the first is just the name of the program.
    for (int i = 1; i < argc; i++) {
        if (0 == strcmp("-h", argv[i]) || 0 == strcmp("--help", argv[i])) {
            // Print help message.
            SkTDArray<const char*> helpFlags;
            for (int j = i + 1; j < argc; j++) {
                if (SkStrStartsWith(argv[j], '-')) {
                    break;
                }
                helpFlags.append(1, &argv[j]);
            }
            if (0 == helpFlags.size()) {
                // Only print general help message if help for specific flags is not requested.
                SkDebugf("%s\n%s\n", argv[0], gUsage.c_str());
            }
            if (!flagsPrinted) {
                SkDebugf("Flags:\n");
                flagsPrinted = true;
            }
            if (0 == helpFlags.size()) {
                // If no flags followed --help, print them all
                SkTDArray<SkFlagInfo*> allFlags;
                for (SkFlagInfo* flag = CommandLineFlags::gHead; flag; flag = flag->next()) {
                    allFlags.push_back(flag);
                }
                SkTQSort(allFlags.begin(), allFlags.end(), CompareFlagsByName());
                for (SkFlagInfo* flag : allFlags) {
                    print_help_for_flag(flag);
                    if (flag->extendedHelp().size() > 0) {
                        SkDebugf("        Use '--help %s' for more information.\n",
                                 flag->name().c_str());
                    }
                }
            } else {
                for (SkFlagInfo* flag = CommandLineFlags::gHead; flag; flag = flag->next()) {
                    for (int k = 0; k < helpFlags.size(); k++) {
                        if (flag->name().equals(helpFlags[k]) ||
                            flag->shortName().equals(helpFlags[k])) {
                            print_extended_help_for_flag(flag);
                            helpFlags.remove(k);
                            break;
                        }
                    }
                }
            }
            if (helpFlags.size() > 0) {
                SkDebugf("Requested help for unrecognized flags:\n");
                for (int k = 0; k < helpFlags.size(); k++) {
                    SkDebugf("    --%s\n", helpFlags[k]);
                }
            }
            helpPrinted = true;
        }
        if (!helpPrinted) {
            SkFlagInfo* matchedFlag = nullptr;
            SkFlagInfo* flag        = gHead;
            int         startI      = i;
            while (flag != nullptr) {
                if (flag->match(argv[startI])) {
                    i = startI;
                    if (matchedFlag) {
                        // Don't redefine the same flag with different types.
                        SkASSERT(matchedFlag->getFlagType() == flag->getFlagType());
                    } else {
                        matchedFlag = flag;
                    }
                    switch (flag->getFlagType()) {
                        case SkFlagInfo::kBool_FlagType:
                            // Can be handled by match, above, but can also be set by the next
                            // string.
                            if (i + 1 < argc && !SkStrStartsWith(argv[i + 1], '-')) {
                                i++;
                                bool value;
                                if (parse_bool_arg(argv[i], &value)) {
                                    flag->setBool(value);
                                }
                            }
                            break;
                        case SkFlagInfo::kString_FlagType:
                            flag->resetStrings();
                            // Add all arguments until another flag is reached.
                            while (i + 1 < argc) {
                                char* end = nullptr;
                                // Negative numbers aren't flags.
                                ignore_result(strtod(argv[i + 1], &end));
                                if (end == argv[i + 1] && SkStrStartsWith(argv[i + 1], '-')) {
                                    break;
                                }
                                i++;
                                flag->append(argv[i]);
                            }
                            break;
                        case SkFlagInfo::kInt_FlagType:
                            i++;
                            flag->setInt(atoi(argv[i]));
                            break;
                        case SkFlagInfo::kDouble_FlagType:
                            i++;
                            flag->setDouble(atof(argv[i]));
                            break;
                        default: SkDEBUGFAIL("Invalid flag type");
                    }
                }
                flag = flag->next();
            }
            if (!matchedFlag) {
#if defined(SK_BUILD_FOR_MAC)
                if (SkStrStartsWith(argv[i], "NSDocumentRevisions") ||
                    SkStrStartsWith(argv[i], "-NSDocumentRevisions")) {
                    i++;  // skip YES
                } else
#endif
                    SkDebugf("Got unknown flag '%s'. Exiting.\n", argv[i]);
                exit(-1);
            }
        }
    }
    // Since all of the flags have been set, release the memory used by each
    // flag. FLAGS_x can still be used after this.
    SkFlagInfo* flag = gHead;
    gHead            = nullptr;
    while (flag != nullptr) {
        SkFlagInfo* next = flag->next();
        delete flag;
        flag = next;
    }
    if (helpPrinted) {
        exit(0);
    }
}

PrintUsage()

void CommandLineFlags::PrintUsage ( )

static

Call this to display the help message. Should be called after SetUsage.

Definition at line 145 of file CommandLineFlags.cpp.

{ SkDebugf("%s", gUsage.c_str()); }

SetUsage()

void CommandLineFlags::SetUsage ( const char *  usage )

static

Call to set the help message to be displayed. Should be called before Parse.

Definition at line 143 of file CommandLineFlags.cpp.

{ gUsage.set(usage); }

ShouldSkip() [1/2]

bool CommandLineFlags::ShouldSkip ( const SkTDArray< const char * > &  strings, const char *  name  )

static

Definition at line 394 of file CommandLineFlags.cpp.

                                                                                         {
    return ShouldSkipImpl(strings, name);
}

ShouldSkip() [2/2]

bool CommandLineFlags::ShouldSkip ( const StringArray &  strings, const char *  name  )

static

Definition at line 397 of file CommandLineFlags.cpp.

                                                                              {
    return ShouldSkipImpl(strings, name);
}

Friends And Related Function Documentation

SkFlagInfo

friend class SkFlagInfo

friend

Definition at line 212 of file CommandLineFlags.h.

---

The documentation for this class was generated from the following files:

• third_party/skia/tools/flags/CommandLineFlags.h
• third_party/skia/tools/flags/CommandLineFlags.cpp