stringfield.php

<?php
namespace Bitrix\Main\ORM\Fields;
 
use Bitrix\Main\DB\SqlExpression;
 
class StringField extends ScalarField
{
    protected $format = null;
 
    protected $size = null;
 
    function __construct($name, $parameters = array())
    {
        parent::__construct($name, $parameters);
 
        if (!empty($parameters['format']))
        {
            $this->format = $parameters['format'];
        }
        if(isset($parameters['size']) && intval($parameters['size']) > 0)
        {
            $this->size = intval($parameters['size']);
        }
    }
 
    public function configureFormat($format)
    {
        $this->format = $format;
        return $this;
    }
 
    public function getFormat()
    {
        return $this->format;
    }
 
    public function getValidators()
    {
        $validators = parent::getValidators();
 
        if ($this->format !== null)
        {
            $validators[] = new Validators\RegExpValidator($this->format);
        }
 
        return $validators;
    }
 
    public function configureSize($size)
    {
        $this->size = $size;
        return $this;
    }
 
    public function getSize()
    {
        return $this->size;
    }
 
    public function cast($value)
    {
        if ($this->is_nullable && $value === null)
        {
            return $value;
        }
 
        if ($value instanceof SqlExpression)
        {
            return $value;
        }
 
        $value = (string) $value;
 
        if ($this->size !== null)
        {
            $value = mb_substr($value, 0, $this->size);
        }
 
        return $value;
    }
 
    public function convertValueFromDb($value)
    {
        return $this->getConnection()->getSqlHelper()->convertFromDbString($value);
    }
 
    public function convertValueToDb($value)
    {
        if ($value instanceof SqlExpression)
        {
            return $value;
        }
 
        return $value === null && $this->is_nullable
            ? $value
            : $this->getConnection()->getSqlHelper()->convertToDbString($value);
    }
}