Qu'est-ce que boost::program_options::notify() pour?

Cette question est sur le C++ Boost program_options bibliothèque.

Tous les tutoriels sont très clairement que je devrais l'appeler notify() sur mon terminé variable de la carte, mais je ne suis pas sûr de ce que cela est en train de faire pour moi. Commentant ne semblent avoir aucun effet, et la documentation n'est pas entré dans le détail:

http://www.boost.org/doc/libs/1_47_0/doc/html/boost/program_options/notify.html

D'autres sources suggèrent qu'il s'exécute "défini par l'utilisateur" des fonctions. Si oui, comment sont les fonctions enregistrées et que font-ils? Ils pourraient lancer des exceptions?

InformationsquelleAutor olooney | 2011-08-19
  1. 25

    notify() est un fonction de membre de value_semantic. C'est un crochet qui est fourni de manière à ce que, une fois la dernière valeur d'une option est déterminé, toute mesure qui doit être prise avec cette option peut être effectué automatiquement et être encapsulé dans sa propre fonction. Cela empêche le code d'avoir une longue fonction qui agit sur chacune des options. Comme les options possibles croître, ce genre de code de procédure peuvent obtenir trop compliqué.

    Vous pouvez voir un exemple de configuration d'un notify fonction dans la Boost manuel:

    options_description desc;
desc.add_options()
    ("compression", value<int>()->default_value(10), "compression level")
    ("email", value< vector<string> >()
        ->composing()->notifier(&your_function), "email")
    ;

    Ces déclarations de spécifier que la valeur par défaut de la première option est
    10, que la deuxième option peut apparaître plusieurs fois et de toutes les instances
    devraient être fusionnés, et qu'après l'analyse est effectuée, la bibliothèque de la
    appel de la fonction &your_function, en passant la valeur de "e-mail" option
    comme argument.

    • Oh, je le vois maintenant. Vous devez regarder pour les "déclarant," de ne pas informer. L'informer de la fonction est passé const référence à la valeur, ne peut donc pas les transformer? Je ne vois pas beaucoup que vous pouvez faire d'autre que de lever une exception si l'option est "mauvais".
    • Le but est que vous prenez quelle que soit l'action envisagée serait avec cette option. Par exemple, si vous avez une option qui change le chemin de recherche, votre notifiant la fonction serait de modifier le chemin de recherche. Comme je l'ai mentionné dans ma réponse, vous pouvez faire cette même logique dans votre option code d'analyse par la vérification de chaque option individuelle, puis en prenant un peu d'action, mais qui peut résulter en une longue procédure blob qui est difficile à lire ou à modifier.
    • Bien sûr, mais sans la capacité de muter le variable_map, passer une opaque poignée pour un objet de l'environnement, ou se lier à foncteur (à l'aide de boost::function, par exemple), vous êtes vraiment limité d'exceptions et de global effets secondaires. C'est toujours utile pour changer le répertoire de travail ou la configuration d'un "verbose" drapeau, mais ce n'est pas assez générale pour déplacer la majeure partie de l'option d'analyse dans les déclarants. Peut-être que je devrais essayer avant de me faire un jugement, si, je suis juste à la théorie de la ici.
    InformationsquelleAutor Conspicuous Compiler
  2. 5

    Je pense que vous êtes sur la bonne voie quand vous parlez de "foncteur"...

    Il est assez commun pour une option de traitement par passage de son argument(s) pour certaines méthode de l'objet. Cela peut être fait plus directement avec les déclarants si vous pouvez envelopper la méthode en quelque chose qui notifiant() accepte comme argument. Et vous pouvez. (Si boost::function a un moyen de le faire, je ne suis pas assez familier avec elle (et je suis trop paresseux pour aller étudier à présent) -- le suivant utilise les routines dans l'en-tête fonctionnelle de STDLIB.)

    Exemple:

    Une de vos options est --config-file, en prenant un argument de type chaîne, qui indique le chemin de la non-fichier de configuration par défaut. Vous avez une classe appelée ConfigParser. Sans déclarants, votre code pourrait ressembler à quelque chose comme ceci:

    ConfigParser *cp = new ConfigParser();
std::string cp_path;
desc.add_options()
    ("config-file", value<std::string>(&cp_path)->default_value("~/.myconfig"), "Config File")
    //... the rest of your options
    ;

cp->setPath(cp_path);

    Avec les déclarants:

    #include <functional>

ConfigParser *cp = new ConfigParser();
desc.add_options()
    ("config-file", value<std::string>()->default_value("~/.myconfig")->notifier(std::bind1st(std::mem_fun(&ConfigParser::setPath), cp)), "Config File")
    //... the rest of your options
    ;
    InformationsquelleAutor Phil