handbook/internal-api/wp-cli-utils-get-flag-value.md
github-actions[bot] c22aa665e6 Regenerate handbook
2025-12-17 18:56:32 +00:00

2.3 KiB

WP_CLI\Utils\get_flag_value()

Return the flag value or, if it's not set, the $default value.


Usage

WP_CLI\Utils\get_flag_value( $assoc_args, $flag, $default = null )
$assoc_args (array<string|int,string|bool>) Arguments array.
$flag (string|int) Flag to get the value.
$default (string|bool|int|null) Default value for the flag. Default: NULL.
@return (string|bool|int|null)

Notes

Because flags can be negated (e.g. --no-quiet to negate --quiet), this function provides a safer alternative to using isset( $assoc_args['quiet'] ) or similar.

Internal API documentation is generated from the WP-CLI codebase on every release. To suggest improvements, please submit a pull request.