ArrayConverter extends AbstractTypeConverter

Converter which transforms strings/arrays to arrays.

Table of Contents

Constants

CONFIGURATION_DELIMITER  = 'delimiter'
CONFIGURATION_LIMIT  = 'limit'
CONFIGURATION_REMOVE_EMPTY_VALUES  = 'removeEmptyValues'

Methods

convertFrom()  : mixed|Error
Convert from $source to $targetType, a noop if the source is an array.
getSourceChildPropertiesToBeConverted()  : array<string|int, mixed>
Return a list of sub-properties inside the source object.
getTargetTypeForSource()  : string
Returns the type for a given source, depending on e.g. the __type setting or other properties.
getTypeOfChildProperty()  : string
Return the type of a given sub-property inside the $targetType

Constants

CONFIGURATION_DELIMITER

public mixed CONFIGURATION_DELIMITER = 'delimiter'

CONFIGURATION_LIMIT

public mixed CONFIGURATION_LIMIT = 'limit'

CONFIGURATION_REMOVE_EMPTY_VALUES

public mixed CONFIGURATION_REMOVE_EMPTY_VALUES = 'removeEmptyValues'

Methods

convertFrom()

Convert from $source to $targetType, a noop if the source is an array.

public convertFrom(string|array<string|int, mixed> $source, string $targetType[, array<string|int, mixed> $convertedChildProperties = [] ][, PropertyMappingConfigurationInterface|null $configuration = null ]) : mixed|Error

If it is an empty string it will be converted to an empty array. If the type converter has a configuration, it can convert non-empty strings, too

Parameters
$source : string|array<string|int, mixed>
$targetType : string
$convertedChildProperties : array<string|int, mixed> = []
$configuration : PropertyMappingConfigurationInterface|null = null
Internal

only to be used within Extbase, not part of TYPO3 Core API.

Return values
mixed|Error —

the target type, or an error object if a user-error occurred

getSourceChildPropertiesToBeConverted()

Return a list of sub-properties inside the source object.

public getSourceChildPropertiesToBeConverted(mixed $source) : array<string|int, mixed>
Parameters
$source : mixed
Tags
todo

this method is only used for converter sources that have children (i.e. objects). Introduce another ChildPropertyAwareTypeConverterInterface and drop this method from the main interface

Returns an empty list of sub property names

Return values
array<string|int, mixed>

getTargetTypeForSource()

Returns the type for a given source, depending on e.g. the __type setting or other properties.

public getTargetTypeForSource(mixed $source, string $originalTargetType[, PropertyMappingConfigurationInterface|null $configuration = null ]) : string
Parameters
$source : mixed

the source data

$originalTargetType : string

the type we originally want to convert to

$configuration : PropertyMappingConfigurationInterface|null = null
Tags
todo

The concept of this method is flawed because it enables the override of the target type depending on the structure of the source. So, technically we no longer convert type A to B but source of type A with structure X to type B defined by X. This makes a type converter non-deterministic.

Returns the $originalTargetType unchanged in this implementation.

Return values
string

getTypeOfChildProperty()

Return the type of a given sub-property inside the $targetType

public getTypeOfChildProperty(string $targetType, string $propertyName, PropertyMappingConfigurationInterface $configuration) : string
Parameters
$targetType : string
$propertyName : string
$configuration : PropertyMappingConfigurationInterface
Tags
todo

this method is only used for converter sources that have children (i.e. objects). Introduce another ChildPropertyAwareTypeConverterInterface and drop this method from the main interface

This method is never called, as getSourceChildPropertiesToBeConverted() returns an empty array.

Return values
string —

the type of $propertyName in $targetType


        

        
    




    

    

                            

            

                            
    

        On this page

        
    


            

                    

        

    

        

            
Search results