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;
        }
        elseif ($value === null && $this->is_nullable)
        {
            return $value;
        }
        elseif ($this->is_binary)
        {
            return $this->getConnection()->getSqlHelper()->convertToDbBinary($value);
        }
        elseif ($this->is_fulltext)
        {
            return $this->getConnection()->getSqlHelper()->convertToFullText($value);
        }
        else
        {
            return $this->getConnection()->getSqlHelper()->convertToDbString($value, $this->size);
        }
    }
}