blob: 21abc3d37e43431f3ed01470c726826a4d20969f [file] [log] [blame]
/*
* Copyright (c) 2020, Alliance for Open Media. All rights reserved.
*
* This source code is subject to the terms of the BSD 2 Clause License and
* the Alliance for Open Media Patent License 1.0. If the BSD 2 Clause License
* was not distributed with this source code in the LICENSE file, you can
* obtain it at www.aomedia.org/license/software. If the Alliance for Open
* Media Patent License 1.0 was not distributed with this source code in the
* PATENTS file, you can obtain it at www.aomedia.org/license/patent.
*/
#ifndef AOM_COMMON_ARGS_HELPER_H_
#define AOM_COMMON_ARGS_HELPER_H_
#include "aom/aom_encoder.h"
#ifdef __cplusplus
extern "C" {
#endif
// Maximum length of the error messages for the helper functions.
#define ARG_ERR_MSG_MAX_LEN 200
struct arg {
char **argv;
const char *name;
const char *val;
unsigned int argv_step;
const struct arg_def *def;
};
struct arg_enum_list {
const char *name;
int val;
};
#define ARG_ENUM_LIST_END \
{ 0 }
typedef struct arg_def {
const char *short_name;
const char *long_name;
int has_val; // 0: The argument must not have a value.
// 1: The argument must have a value.
// -1: The argument may or may not have a value.
const char *desc;
const struct arg_enum_list *enums;
} arg_def_t;
#define ARG_DEF(s, l, v, d) \
{ s, l, v, d, NULL }
#define ARG_DEF_ENUM(s, l, v, d, e) \
{ s, l, v, d, e }
#define ARG_DEF_LIST_END \
{ 0 }
/*
* The helper functions below all take an optional parameter err_msg for
* error reporting. When err_msg is not NULL (must point to a buffer
* which is at least ARG_ERR_MSG_MAX_LEN bytes long), a related error message is
* stored in it if an error occurs. It will be set to an empty string if no
* error occurs.
*/
int arg_match_helper(struct arg *arg_, const struct arg_def *def, char **argv,
char *err_msg);
// Note: arg_match_helper() must be called before invoking these functions.
unsigned int arg_parse_uint_helper(const struct arg *arg, char *err_msg);
int arg_parse_int_helper(const struct arg *arg, char *err_msg);
struct aom_rational arg_parse_rational_helper(const struct arg *arg,
char *err_msg);
int arg_parse_enum_helper(const struct arg *arg, char *err_msg);
int arg_parse_enum_or_int_helper(const struct arg *arg, char *err_msg);
int arg_parse_list_helper(const struct arg *arg, int *list, int n,
char *err_msg);
#ifdef __cplusplus
} // extern "C"
#endif
#endif // AOM_COMMON_ARGS_HELPER_H_