absl::FlagsUsageConfig

This structure contains the collection of callbacks for changing the behavior of the usage reporting routines in Abseil Flags.

Synopsis

Declared in <absl/flags/usage_config.h>

struct FlagsUsageConfig;

Data Members

NameDescription
contains_help_flags Returns true if flags defined in the filename should be reported with --help flag. For example, if the file "path/to/my/code.cc" defines the flag "--my_flag", and contains_help_flags("path/to/my/code.cc") returns true, invoking the program with --help will include information about --my_flag in the program output.
contains_helppackage_flags Returns true if flags defined in the filename should be reported with --helppackage flag. For example, if the file "path/to/my/code.cc" defines the flag "--my_flag", and contains_helppackage_flags("path/to/my/code.cc") returns true, invoking the program with --helppackage will include information about --my_flag in the program output.
contains_helpshort_flags Returns true if flags defined in the given source code file should be reported with --helpshort flag. For example, if the file "path/to/my/code.cc" defines the flag "--my_flag", and contains_helpshort_flags("path/to/my/code.cc") returns true, invoking the program with --helpshort will include information about --my_flag in the program output.
normalize_filename Normalizes the filename specific to the build system/filesystem used. This routine is used when we report the information about the flag definition location. For instance, if your build resides at some location you do not want to expose in the usage output, you can trim it to show only relevant part. For example: normalize_filename("/my_company/some_long_path/src/project/file.cc") might produce "project/file.cc".
version_string Generates string containing program version. This is the string reported when user specifies --version in a command line.

Non-Member Functions

NameDescription
SetFlagsUsageConfigSets the usage reporting configuration callbacks. If any of the callbacks are not set in usage_config instance, then the default value of the callback is used.