eddys_snippets/HSFW_management/cmdlnopts.c

/*
 * cmdlnopts.c - the only function that parse cmdln args and returns glob parameters
 *
 * Copyright 2013 Edward V. Emelianoff <eddy@sao.ru>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 * MA 02110-1301, USA.
 */
#include <assert.h>
#include <stdio.h>
#include <string.h>
#include <strings.h>
#include <math.h>
#include "cmdlnopts.h"
#include "usefull_macros.h"

#define RAD 57.2957795130823
#define D2R(x) ((x) / RAD)
#define R2D(x) ((x) * RAD)

/*
 * here are global parameters initialisation
 */
int help;
glob_pars G;

int listNms   = LIST_NONE   // list names
    ,gohome   = 0           // first go home
    ,reName   = 0           // rename wheels/positions
    ,showpos  = 0           // show current position (if none args)
    ,setdef   = 0           // reset all names to default values
;


//            DEFAULTS
// default global parameters
glob_pars const Gdefault = {
     NULL          // wheelID
    ,NULL          // wheelName
    ,NULL          // serial
    ,0             // filterPos ( 0 - get current position)
    ,NULL          // filterName
    ,NULL          // filterId
};

/*
 * Define command line options by filling structure:
 *  name    has_arg flag    val     type        argptr          help
*/
myoption cmdlnopts[] = {
    /// "ÏÔÏÂÒÁÚÉÔØ ÜÔÕ ÓÐÒÁ×ËÕ"
    {"help",    NO_ARGS,    NULL,   'h',    arg_int,    APTR(&help),        N_("show this help")},
    /// "ÂÕË×ÅÎÎÙÊ ÉÄÅÎÔÉÆÉËÁÔÏÒ ËÏÌÅÓÁ"
    {"wheel-id",NEED_ARG,   NULL,   'W',    arg_string, APTR(&G.wheelID),   N_("letter wheel identificator")},
    /// "ÎÁÚ×ÁÎÉÅ ËÏÌÅÓÁ"
    {"wheel-name",NEED_ARG, NULL,   'N',    arg_string, APTR(&G.wheelName), N_("wheel name")},
    /// "ÓÅÒÉÊÎÙÊ ÎÏÍÅÒ ÔÕÒÅÌÉ (Ó ÎÁÞÁÌØÎÙÍÉ ÎÕÌÑÍÉ)"
    {"serial",  NEED_ARG,   NULL,   's',    arg_string, APTR(&G.serial),    N_("turret serial (with leading zeros)")},
    /// "ÎÏÍÅÒ ÐÏÚÉÃÉÉ ÆÉÌØÔÒÁ"
    {"f-position",NEED_ARG, NULL,   'p',    arg_int,    APTR(&G.filterPos), N_("filter position number")},
    /// "ÎÁÚ×ÁÎÉÅ ÆÉÌØÔÒÁ"
    {"filter-name",NEED_ARG,NULL,   'n',    arg_string, APTR(&G.filterName),N_("filter name")},
    /// "ÉÄÅÎÔÉÆÉËÁÔÏÒ ÆÉÌØÔÒÁ, ÎÁÐÒÉÍÅÒ, \"A3\""
    {"filter-id",NEED_ARG,  NULL,   'i',    arg_string, APTR(&G.filterId),  N_("filter identificator like \"A3\"")},
    /// "ÓÐÉÓÏË ×ÓÅÈ ÓÏÈÒÁÎÅÎÎÙÈ ÉÍÅÎ"
    {"list-all",NO_ARGS,    &listNms,LIST_ALL,arg_none, NULL,               N_("list all stored names")},
    /// "ÓÐÉÓÏË ÉÍÅÎ ÔÏÌØËÏ ÐÒÉÓÕÔÓÔ×ÕÀÝÉÈ ÕÓÔÒÏÊÓÔ×"
    {"list",    NO_ARGS,    &listNms,LIST_PRES,arg_none,NULL,               N_("list only present devices' names")},
    /// "ÐÅÒÅÍÅÓÔÉÔØÓÑ × ÓÔÁÒÔÏ×ÕÀ ÐÏÚÉÃÉÀ"
    {"home",    NO_ARGS,    NULL,   'H',    arg_none,   &gohome,            N_("move to home position")},
    /// "ÐÅÒÅÉÍÅÎÏ×ÁÔØ ÓÏÈÒÁÎÅÎÎÙÅ ÉÍÅÎÁ ËÏÌÅÓ/ÆÉÌØÔÒÏ×"
    {"rename",  NO_ARGS,    &reName,1,      arg_none,   NULL,               N_("rename stored wheels/filters names")},
    {"resetnames",NO_ARGS,  &setdef,1,      arg_none,   NULL,               N_("reset all names to default values")},
    end_option
};

/**
 * Safely convert data from string to double
 *
 * @param num (o) - double number read from string
 * @param str (i) - input string
 * @return TRUE if success
 */
bool myatod(double *num, const char *str){
    double res;
    char *endptr;
    assert(str);
    res = strtod(str, &endptr);
    if(endptr == str || *str == '\0' || *endptr != '\0'){
        /// "îÅÐÒÁ×ÉÌØÎÙÊ ÆÏÒÍÁÔ ÞÉÓÌÁ double!"
        WARNX(_("Wrong double number format!"));
        return FALSE;
    }
    *num = res;
    return TRUE;
}

/**
 * Parse command line options and return dynamically allocated structure
 *      to global parameters
 * @param argc - copy of argc from main
 * @param argv - copy of argv from main
 * @return allocated structure with global parameters
 */
glob_pars *parse_args(int argc, char **argv){
    int i, oldargc = argc - 1;
    void *ptr;
    ptr = memcpy(&G, &Gdefault, sizeof(G)); assert(ptr);
    /// "éÓÐÏÌØÚÏ×ÁÎÉÅ: %s [ÁÒÇÕÍÅÎÔÙ] [ÐÒÅÆÉËÓ ×ÙÈÏÄÎÏÇÏ ÆÁÊÌÁ]\n\n\tçÄÅ [ÁÒÇÕÍÅÎÔÙ]:\n"
    //change_helpstring(_("Usage: %s [args] [outfile prefix] [file list for group operations]\n\n\tWhere args are:\n"));
    // parse arguments
    parseargs(&argc, &argv, cmdlnopts);
    if(help) showhelp(-1, cmdlnopts);
    if(argc > 0){
        /// "éÇÎÏÒÉÒÕÀÔÓÑ ÐÁÒÁÍÅÔÒÙ: "
        WARNX(_("Ignore parameters:"));
        for (i = 0; i < argc; i++){
            printf("%s\n", argv[i]);
        }
    }
    if(argc == oldargc){ // no parameters given or given only wrong parameters
        //showpos = 1;
        listNms = LIST_SHORT; // short list of turrets present
    }
    return &G;
}