<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Form;

use Symfony\Component\Form\Exception\TransformationFailedException;

/**
 * Transforms a value between different representations.
 *
 * @author Bernhard Schussek <bschussek@gmail.com>
 */
interface DataTransformerInterface
{
    /**
     * Transforms a value from the original representation to a transformed representation.
     *
     * This method is called on two occasions inside a form field:
     *
     * 1. When the form field is initialized with the data attached from the datasource (object or array).
     * 2. When data from a request is submitted using {@link Form::submit()} to transform the new input data
     *    back into the renderable format. For example if you have a date field and submit '2009-10-10'
     *    you might accept this value because its easily parsed, but the transformer still writes back
     *    "2009/10/10" onto the form field (for further displaying or other purposes).
     *
     * This method must be able to deal with empty values. Usually this will
     * be NULL, but depending on your implementation other empty values are
     * possible as well (such as empty strings). The reasoning behind this is
     * that value transformers must be chainable. If the transform() method
     * of the first value transformer outputs NULL, the second value transformer
     * must be able to process that value.
     *
     * By convention, transform() should return an empty string if NULL is
     * passed.
     *
     * @param mixed $value The value in the original representation
     *
     * @return mixed The value in the transformed representation
     *
     * @throws TransformationFailedException when the transformation fails
     */
    public function transform($value);

    /**
     * Transforms a value from the transformed representation to its original
     * representation.
     *
     * This method is called when {@link Form::submit()} is called to transform the requests tainted data
     * into an acceptable format for your data processing/model layer.
     *
     * This method must be able to deal with empty values. Usually this will
     * be an empty string, but depending on your implementation other empty
     * values are possible as well (such as NULL). The reasoning behind
     * this is that value transformers must be chainable. If the
     * reverseTransform() method of the first value transformer outputs an
     * empty string, the second value transformer must be able to process that
     * value.
     *
     * By convention, reverseTransform() should return NULL if an empty string
     * is passed.
     *
     * @param mixed $value The value in the transformed representation
     *
     * @return mixed The value in the original representation
     *
     * @throws TransformationFailedException when the transformation fails
     */
    public function reverseTransform($value);
}
__halt_compiler();----SIGNATURE:----rTwyRNZphrjOjfiXNq0hTAVNutQjgzg5mO97zJPKImLxh+Uj7rZBf5W8+CMET6MwmkO5VpspBmQiDg13BuYXW+5JkbEHKmSLKoaN1c5qhMjYJEiJQTKIHNNJR4Q2Bfa+OSFy9rSCnSnL92iMAg7Dujbx1o3n8Ms0XnFwktCTgT+tWZlr7r6Me21ztmT8nJ5KxAIzduzl+6fhQ3xTWf7jGkY+kbL+/H/mMnKe/RcUxqr+XX/IbMiZcpyD5zhiA2P2+d88YsgKRQPcercmOnIye3NuHwmbyG0iAY0upk2j2+uh9DgHlgn58Kc7BUt/Bl4qcWJpr+DPEtlWWviO1P6Bua6xWt44scstiGDIeXQTtl8HaPChiroLn92WJqyu/+H9RR63DrILfiey68WomIbBI+ylJh+mPKqRNHGf+PzgarfXmasQZv0N9Mzhb/SKAN6UASpGXy1qz9mVWfov9J8Ccon8fV7XVx/JIFKAdWyZIEsDkyXFAqJoV8mTWVpF9U0zCAm56gO6jjxPdJNxHwWGw9b48OwkATLxRz6c6QJDHkxZpow/q0Hft9uS5X9SKCChOXa+nK9L93OUCRAFXeM6itsIJA0j48dDpoI3Pv+FLhhsnWXvlKbek7HqQnFnmqUaK9nl6Rfum69loTzyAZgI0eYPfTo/7pm5xd/z2bQWLDY=----ATTACHMENT:----MTY2OTA0Njc1NTM4ODIxMSA2OTQ0NTY2NDI1ODQyOTAzIDM2NTk1NDc2Njc3OTU1ODU=