Mercurial > hg > rc1
comparison vendor/pear/console_commandline/Console/CommandLine/Action/Callback.php @ 0:1e000243b222
vanilla 1.3.3 distro, I hope
| author | Charlie Root |
|---|---|
| date | Thu, 04 Jan 2018 15:50:29 -0500 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| -1:000000000000 | 0:1e000243b222 |
|---|---|
| 1 <?php | |
| 2 | |
| 3 /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */ | |
| 4 | |
| 5 /** | |
| 6 * This file is part of the PEAR Console_CommandLine package. | |
| 7 * | |
| 8 * PHP version 5 | |
| 9 * | |
| 10 * LICENSE: This source file is subject to the MIT license that is available | |
| 11 * through the world-wide-web at the following URI: | |
| 12 * http://opensource.org/licenses/mit-license.php | |
| 13 * | |
| 14 * @category Console | |
| 15 * @package Console_CommandLine | |
| 16 * @author David JEAN LOUIS <izimobil@gmail.com> | |
| 17 * @copyright 2007 David JEAN LOUIS | |
| 18 * @license http://opensource.org/licenses/mit-license.php MIT License | |
| 19 * @version CVS: $Id$ | |
| 20 * @link http://pear.php.net/package/Console_CommandLine | |
| 21 * @since File available since release 0.1.0 | |
| 22 * @filesource | |
| 23 */ | |
| 24 | |
| 25 /** | |
| 26 * Required by this class. | |
| 27 */ | |
| 28 require_once 'Console/CommandLine/Action.php'; | |
| 29 | |
| 30 /** | |
| 31 * Class that represent the Callback action. | |
| 32 * | |
| 33 * The result option array entry value is set to the return value of the | |
| 34 * callback defined in the option. | |
| 35 * | |
| 36 * There are two steps to defining a callback option: | |
| 37 * - define the option itself using the callback action | |
| 38 * - write the callback; this is a function (or method) that takes five | |
| 39 * arguments, as described below. | |
| 40 * | |
| 41 * All callbacks are called as follows: | |
| 42 * <code> | |
| 43 * callable_func( | |
| 44 * $value, // the value of the option | |
| 45 * $option_instance, // the option instance | |
| 46 * $result_instance, // the result instance | |
| 47 * $parser_instance, // the parser instance | |
| 48 * $params // an array of params as specified in the option | |
| 49 * ); | |
| 50 * </code> | |
| 51 * and *must* return the option value. | |
| 52 * | |
| 53 * @category Console | |
| 54 * @package Console_CommandLine | |
| 55 * @author David JEAN LOUIS <izimobil@gmail.com> | |
| 56 * @copyright 2007 David JEAN LOUIS | |
| 57 * @license http://opensource.org/licenses/mit-license.php MIT License | |
| 58 * @version Release: @package_version@ | |
| 59 * @link http://pear.php.net/package/Console_CommandLine | |
| 60 * @since Class available since release 0.1.0 | |
| 61 */ | |
| 62 class Console_CommandLine_Action_Callback extends Console_CommandLine_Action | |
| 63 { | |
| 64 // execute() {{{ | |
| 65 | |
| 66 /** | |
| 67 * Executes the action with the value entered by the user. | |
| 68 * | |
| 69 * @param mixed $value The value of the option | |
| 70 * @param array $params An optional array of parameters | |
| 71 * | |
| 72 * @return string | |
| 73 */ | |
| 74 public function execute($value = false, $params = array()) | |
| 75 { | |
| 76 $this->setResult(call_user_func($this->option->callback, $value, | |
| 77 $this->option, $this->result, $this->parser, $params)); | |
| 78 } | |
| 79 // }}} | |
| 80 } |
