* * @internal since 8.8.0 */ protected $components; /** * @var non-empty-string * * @internal since 8.8.0 */ protected $separator; /** * @param array|Value|string $components * @param non-empty-string $separator * @param int<1, max>|null $lineNumber */ public function __construct($components = [], $separator = ',', ?int $lineNumber = null) { parent::__construct($lineNumber); if (!\is_array($components)) { $components = [$components]; } $this->components = $components; $this->separator = $separator; } /** * @param Value|string $component */ public function addListComponent($component): void { $this->components[] = $component; } /** * @return array */ public function getListComponents(): array { return $this->components; } /** * @param array $components */ public function setListComponents(array $components): void { $this->components = $components; } /** * @return non-empty-string */ public function getListSeparator(): string { return $this->separator; } /** * @param non-empty-string $separator */ public function setListSeparator(string $separator): void { $this->separator = $separator; } public function render(OutputFormat $outputFormat): string { $formatter = $outputFormat->getFormatter(); return $formatter->implode( $formatter->spaceBeforeListArgumentSeparator($this->separator) . $this->separator . $formatter->spaceAfterListArgumentSeparator($this->separator), $this->components ); } /** * @return array|null> * * @internal */ public function getArrayRepresentation(): array { return [ 'class' => $this->getShortClassName(), 'components' => \array_map( /** * @parm Value|string $component */ function ($component): array { if (\is_string($component)) { return ['class' => 'string', 'value' => $component]; } return $component->getArrayRepresentation(); }, $this->components ), 'separator' => $this->separator, ]; } }