InvalidArgumentHelper.php (3159B)
1 <?php 2 /** 3 * PHP_CodeCoverage 4 * 5 * Copyright (c) 2009-2014, Sebastian Bergmann <sebastian@phpunit.de>. 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 12 * * Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 15 * * Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in 17 * the documentation and/or other materials provided with the 18 * distribution. 19 * 20 * * Neither the name of Sebastian Bergmann nor the names of his 21 * contributors may be used to endorse or promote products derived 22 * from this software without specific prior written permission. 23 * 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 27 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 28 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 29 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 30 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 31 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 34 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35 * POSSIBILITY OF SUCH DAMAGE. 36 * 37 * @category PHP 38 * @package CodeCoverage 39 * @author Sebastian Bergmann <sebastian@phpunit.de> 40 * @copyright 2009-2014 Sebastian Bergmann <sebastian@phpunit.de> 41 * @license http://www.opensource.org/licenses/BSD-3-Clause The BSD 3-Clause License 42 * @link http://github.com/sebastianbergmann/php-code-coverage 43 * @since File available since Release 1.2.0 44 */ 45 46 /** 47 * Factory for PHP_CodeCoverage_Exception objects that are used to describe 48 * invalid arguments passed to a function or method. 49 * 50 * @category PHP 51 * @package CodeCoverage 52 * @author Sebastian Bergmann <sebastian@phpunit.de> 53 * @copyright 2009-2014 Sebastian Bergmann <sebastian@phpunit.de> 54 * @license http://www.opensource.org/licenses/BSD-3-Clause The BSD 3-Clause License 55 * @link http://github.com/sebastianbergmann/php-code-coverage 56 * @since Class available since Release 1.2.0 57 */ 58 class PHP_CodeCoverage_Util_InvalidArgumentHelper 59 { 60 /** 61 * @param integer $argument 62 * @param string $type 63 * @param mixed $value 64 */ 65 public static function factory($argument, $type, $value = NULL) 66 { 67 $stack = debug_backtrace(FALSE); 68 69 return new PHP_CodeCoverage_Exception( 70 sprintf( 71 'Argument #%d%sof %s::%s() must be a %s', 72 $argument, 73 $value !== NULL ? ' (' . $value . ')' : ' ', 74 $stack[1]['class'], 75 $stack[1]['function'], 76 $type 77 ) 78 ); 79 } 80 }