1 /** @file RNAduplex_cmdl.h
2 * @brief The header file for the command line option parser
3 * generated by GNU Gengetopt version 2.22.5
4 * http://www.gnu.org/software/gengetopt.
5 * DO NOT modify this file, since it can be overwritten
6 * @author GNU Gengetopt by Lorenzo Bettini */
8 #ifndef RNADUPLEX_CMDL_H
9 #define RNADUPLEX_CMDL_H
11 /* If we use autoconf. */
16 #include <stdio.h> /* for FILE */
20 #endif /* __cplusplus */
22 #ifndef RNADUPLEX_CMDLINE_PARSER_PACKAGE
23 /** @brief the program name (used for printing errors) */
24 #define RNADUPLEX_CMDLINE_PARSER_PACKAGE "RNAduplex"
27 #ifndef RNADUPLEX_CMDLINE_PARSER_PACKAGE_NAME
28 /** @brief the complete program name (used for help and version) */
29 #define RNADUPLEX_CMDLINE_PARSER_PACKAGE_NAME "RNAduplex"
32 #ifndef RNADUPLEX_CMDLINE_PARSER_VERSION
33 /** @brief the program version */
34 #define RNADUPLEX_CMDLINE_PARSER_VERSION VERSION
37 /** @brief Where the command line options are stored */
38 struct RNAduplex_args_info
40 const char *help_help; /**< @brief Print help and exit help description. */
41 const char *detailed_help_help; /**< @brief Print help, including all details and hidden options, and exit help description. */
42 const char *full_help_help; /**< @brief Print help, including hidden options, and exit help description. */
43 const char *version_help; /**< @brief Print version and exit help description. */
44 int sorted_flag; /**< @brief sort the printed output by free energy
47 const char *sorted_help; /**< @brief sort the printed output by free energy
50 int noconv_flag; /**< @brief Do not automatically substitude nucleotide \"T\" with \"U\"
53 const char *noconv_help; /**< @brief Do not automatically substitude nucleotide \"T\" with \"U\"
56 float deltaEnergy_arg; /**< @brief Compute suboptimal structures with energy in a certain range of the optimum (kcal/mol). Default is calculation of mfe structure only.
59 char * deltaEnergy_orig; /**< @brief Compute suboptimal structures with energy in a certain range of the optimum (kcal/mol). Default is calculation of mfe structure only.
61 original value given at command line. */
62 const char *deltaEnergy_help; /**< @brief Compute suboptimal structures with energy in a certain range of the optimum (kcal/mol). Default is calculation of mfe structure only.
65 double temp_arg; /**< @brief Rescale energy parameters to a temperature of temp C. Default is 37C.
68 char * temp_orig; /**< @brief Rescale energy parameters to a temperature of temp C. Default is 37C.
70 original value given at command line. */
71 const char *temp_help; /**< @brief Rescale energy parameters to a temperature of temp C. Default is 37C.
74 int noTetra_flag; /**< @brief Do not include special tabulated stabilizing energies for tri-, tetra- and hexaloop hairpins. Mostly for testing.
77 const char *noTetra_help; /**< @brief Do not include special tabulated stabilizing energies for tri-, tetra- and hexaloop hairpins. Mostly for testing.
80 int dangles_arg; /**< @brief How to treat \"dangling end\" energies for bases adjacent to helices in free ends and multi-loops
82 char * dangles_orig; /**< @brief How to treat \"dangling end\" energies for bases adjacent to helices in free ends and multi-loops
83 original value given at command line. */
84 const char *dangles_help; /**< @brief How to treat \"dangling end\" energies for bases adjacent to helices in free ends and multi-loops
86 int noLP_flag; /**< @brief Produce structures without lonely pairs (helices of length 1).
88 const char *noLP_help; /**< @brief Produce structures without lonely pairs (helices of length 1).
90 int noGU_flag; /**< @brief Do not allow GU pairs
93 const char *noGU_help; /**< @brief Do not allow GU pairs
96 int noClosingGU_flag; /**< @brief Do not allow GU pairs at the end of helices
99 const char *noClosingGU_help; /**< @brief Do not allow GU pairs at the end of helices
102 char * paramFile_arg; /**< @brief Read energy parameters from paramfile, instead of using the default parameter set.
104 char * paramFile_orig; /**< @brief Read energy parameters from paramfile, instead of using the default parameter set.
105 original value given at command line. */
106 const char *paramFile_help; /**< @brief Read energy parameters from paramfile, instead of using the default parameter set.
108 char * nsp_arg; /**< @brief Allow other pairs in addition to the usual AU,GC,and GU pairs.
110 char * nsp_orig; /**< @brief Allow other pairs in addition to the usual AU,GC,and GU pairs.
111 original value given at command line. */
112 const char *nsp_help; /**< @brief Allow other pairs in addition to the usual AU,GC,and GU pairs.
115 unsigned int help_given ; /**< @brief Whether help was given. */
116 unsigned int detailed_help_given ; /**< @brief Whether detailed-help was given. */
117 unsigned int full_help_given ; /**< @brief Whether full-help was given. */
118 unsigned int version_given ; /**< @brief Whether version was given. */
119 unsigned int sorted_given ; /**< @brief Whether sorted was given. */
120 unsigned int noconv_given ; /**< @brief Whether noconv was given. */
121 unsigned int deltaEnergy_given ; /**< @brief Whether deltaEnergy was given. */
122 unsigned int temp_given ; /**< @brief Whether temp was given. */
123 unsigned int noTetra_given ; /**< @brief Whether noTetra was given. */
124 unsigned int dangles_given ; /**< @brief Whether dangles was given. */
125 unsigned int noLP_given ; /**< @brief Whether noLP was given. */
126 unsigned int noGU_given ; /**< @brief Whether noGU was given. */
127 unsigned int noClosingGU_given ; /**< @brief Whether noClosingGU was given. */
128 unsigned int paramFile_given ; /**< @brief Whether paramFile was given. */
129 unsigned int nsp_given ; /**< @brief Whether nsp was given. */
133 /** @brief The additional parameters to pass to parser functions */
134 struct RNAduplex_cmdline_parser_params
136 int override; /**< @brief whether to override possibly already present options (default 0) */
137 int initialize; /**< @brief whether to initialize the option structure RNAduplex_args_info (default 1) */
138 int check_required; /**< @brief whether to check that all required options were provided (default 1) */
139 int check_ambiguity; /**< @brief whether to check for options already specified in the option structure RNAduplex_args_info (default 0) */
140 int print_errors; /**< @brief whether getopt_long should print an error message for a bad option (default 1) */
143 /** @brief the purpose string of the program */
144 extern const char *RNAduplex_args_info_purpose;
145 /** @brief the usage string of the program */
146 extern const char *RNAduplex_args_info_usage;
147 /** @brief all the lines making the help output */
148 extern const char *RNAduplex_args_info_help[];
149 /** @brief all the lines making the full help output (including hidden options) */
150 extern const char *RNAduplex_args_info_full_help[];
151 /** @brief all the lines making the detailed help output (including hidden options and details) */
152 extern const char *RNAduplex_args_info_detailed_help[];
155 * The command line parser
156 * @param argc the number of command line options
157 * @param argv the command line options
158 * @param args_info the structure where option information will be stored
159 * @return 0 if everything went fine, NON 0 if an error took place
161 int RNAduplex_cmdline_parser (int argc, char **argv,
162 struct RNAduplex_args_info *args_info);
165 * The command line parser (version with additional parameters - deprecated)
166 * @param argc the number of command line options
167 * @param argv the command line options
168 * @param args_info the structure where option information will be stored
169 * @param override whether to override possibly already present options
170 * @param initialize whether to initialize the option structure my_args_info
171 * @param check_required whether to check that all required options were provided
172 * @return 0 if everything went fine, NON 0 if an error took place
173 * @deprecated use RNAduplex_cmdline_parser_ext() instead
175 int RNAduplex_cmdline_parser2 (int argc, char **argv,
176 struct RNAduplex_args_info *args_info,
177 int override, int initialize, int check_required);
180 * The command line parser (version with additional parameters)
181 * @param argc the number of command line options
182 * @param argv the command line options
183 * @param args_info the structure where option information will be stored
184 * @param params additional parameters for the parser
185 * @return 0 if everything went fine, NON 0 if an error took place
187 int RNAduplex_cmdline_parser_ext (int argc, char **argv,
188 struct RNAduplex_args_info *args_info,
189 struct RNAduplex_cmdline_parser_params *params);
192 * Save the contents of the option struct into an already open FILE stream.
193 * @param outfile the stream where to dump options
194 * @param args_info the option struct to dump
195 * @return 0 if everything went fine, NON 0 if an error took place
197 int RNAduplex_cmdline_parser_dump(FILE *outfile,
198 struct RNAduplex_args_info *args_info);
201 * Save the contents of the option struct into a (text) file.
202 * This file can be read by the config file parser (if generated by gengetopt)
203 * @param filename the file where to save
204 * @param args_info the option struct to save
205 * @return 0 if everything went fine, NON 0 if an error took place
207 int RNAduplex_cmdline_parser_file_save(const char *filename,
208 struct RNAduplex_args_info *args_info);
213 void RNAduplex_cmdline_parser_print_help(void);
215 * Print the full help (including hidden options)
217 void RNAduplex_cmdline_parser_print_full_help(void);
219 * Print the detailed help (including hidden options and details)
221 void RNAduplex_cmdline_parser_print_detailed_help(void);
225 void RNAduplex_cmdline_parser_print_version(void);
228 * Initializes all the fields a RNAduplex_cmdline_parser_params structure
229 * to their default values
230 * @param params the structure to initialize
232 void RNAduplex_cmdline_parser_params_init(struct RNAduplex_cmdline_parser_params *params);
235 * Allocates dynamically a RNAduplex_cmdline_parser_params structure and initializes
236 * all its fields to their default values
237 * @return the created and initialized RNAduplex_cmdline_parser_params structure
239 struct RNAduplex_cmdline_parser_params *RNAduplex_cmdline_parser_params_create(void);
242 * Initializes the passed RNAduplex_args_info structure's fields
243 * (also set default values for options that have a default)
244 * @param args_info the structure to initialize
246 void RNAduplex_cmdline_parser_init (struct RNAduplex_args_info *args_info);
248 * Deallocates the string fields of the RNAduplex_args_info structure
249 * (but does not deallocate the structure itself)
250 * @param args_info the structure to deallocate
252 void RNAduplex_cmdline_parser_free (struct RNAduplex_args_info *args_info);
255 * Checks that all the required options were specified
256 * @param args_info the structure to check
257 * @param prog_name the name of the program that will be used to print
261 int RNAduplex_cmdline_parser_required (struct RNAduplex_args_info *args_info,
262 const char *prog_name);
267 #endif /* __cplusplus */
268 #endif /* RNADUPLEX_CMDL_H */