vendor/doctrine/dbal/lib/Doctrine/DBAL/Types/ConversionException.php

   1 <?php
   2 /*
   3  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   4  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   5  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
   6  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
   7  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   8  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   9  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  10  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  11  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  12  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  13  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  14  *
  15  * This software consists of voluntary contributions made by many individuals
  16  * and is licensed under the MIT license. For more information, see
  17  * <http://www.doctrine-project.org>.
  18  */
  19
  20
  21 /**
  22  * Conversion Exception is thrown when the database to PHP conversion fails
  23  *
  24  * @license     http://www.opensource.org/licenses/lgpl-license.php LGPL
  25  * @link        www.doctrine-project.com
  26  * @since       2.0
  27  * @author      Benjamin Eberlei <kontakt@beberlei.de>
  28  * @author      Guilherme Blanco <guilhermeblanco@hotmail.com>
  29  * @author      Jonathan Wage <jonwage@gmail.com>
  30  * @author      Roman Borschel <roman@code-factory.org>
  31  */
  32 namespace Doctrine\DBAL\Types;
  33
  34 class ConversionException extends \Doctrine\DBAL\DBALException
  35 {
  36     /**
  37      * Thrown when a Database to Doctrine Type Conversion fails.
  38      *
  39      * @param  string $value
  40      * @param  string $toType
  41      * @return ConversionException
  42      */
  43     static public function conversionFailed($value, $toType)
  44     {
  45         $value = (strlen($value) > 32) ? substr($value, 0, 20) . "..." : $value;
  46         return new self('Could not convert database value "' . $value . '" to Doctrine Type ' . $toType);
  47     }
  48
  49     /**
  50      * Thrown when a Database to Doctrine Type Conversion fails and we can make a statement
  51      * about the expected format.
  52      *
  53      * @param  string $value
  54      * @param  string $toType
  55      * @return ConversionException
  56      */
  57     static public function conversionFailedFormat($value, $toType, $expectedFormat)
  58     {
  59         $value = (strlen($value) > 32) ? substr($value, 0, 20) . "..." : $value;
  60         return new self(
  61             'Could not convert database value "' . $value . '" to Doctrine Type ' .
  62             $toType . '. Expected format: ' . $expectedFormat
  63         );
  64     }
  65 }