packages/sql-semantics-mysql/resources/models/Value/AlterListItemWithConvertSymToSymCharsetCharsetNameOrDefaultOptCollate_d025d9c2.php

1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\MySql\Value;
6
7/**
8 * The alter_list_item SQL value; generated by bin/build-models.php.
9 *
10 * @visibility public
11 * @example Accept a structured SQL value
12 *     $write = static fn (\SqlSemantics\Statement\Model\MySql\Value\AlterListItemWithConvertSymToSymCharsetCharsetNameOrDefaultOptCollate_d025d9c2 $value): string => \SqlSemantics\Statement\Writer::render($value);
13 *     $write instanceof \Closure // => true
14 */
15final class AlterListItemWithConvertSymToSymCharsetCharsetNameOrDefaultOptCollate_d025d9c2 implements \SqlSemantics\Statement\Model\MySql\Role\AlterCommandListForm, \SqlSemantics\Statement\Model\MySql\Role\AlterCommandsForm, \SqlSemantics\Statement\Model\MySql\Role\AlterListForm, \SqlSemantics\Statement\Model\MySql\Role\AlterListItemForm, \SqlSemantics\Statement\Model\MySql\Role\OptAlterCommandListForm, \SqlSemantics\Statement\Model\MySql\Role\OptAlterTableActionsForm
16{
17    use \SqlSemantics\Statement\Assertion;
18
19    /**
20     * Supplies the SQL values of this form; comments are kept by the position of the symbol each precedes.
21     */
22    public function __construct(
23        public readonly \SqlSemantics\Statement\Model\MySql\Role\CharsetForm $charset,
24        public readonly \SqlSemantics\Statement\Model\MySql\Role\CharsetNameOrDefaultForm $charsetNameOrDefault,
25        public readonly \SqlSemantics\Statement\Model\MySql\Role\OptCollateForm $optCollate,
26        public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
27    ) {
28        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($charset), 'The charset must be a generated immutable SQL value.');
29        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($charsetNameOrDefault), 'The charsetNameOrDefault must be a generated immutable SQL value.');
30        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($optCollate), 'The optCollate must be a generated immutable SQL value.');
31    }
32
33    /**
34     * Writes SQL entirely from this value's fields.
35     */
36    public function write(\SqlSemantics\Statement\Writer $writer): void
37    {
38        $writer->comments($this->comments, 0);
39        $writer->append('CONVERT');
40        $writer->comments($this->comments, 1);
41        $writer->append('TO');
42        $writer->comments($this->comments, 2);
43        $this->charset->write($writer);
44        $writer->comments($this->comments, 3);
45        $this->charsetNameOrDefault->write($writer);
46        $writer->comments($this->comments, 4);
47        $this->optCollate->write($writer);
48    }
49
50    /**
51     * Returns a copy with a new charset, preserving every other field.
52     */
53    public function withCharset(\SqlSemantics\Statement\Model\MySql\Role\CharsetForm $charset): self
54    {
55        return new self($charset, $this->charsetNameOrDefault, $this->optCollate, $this->comments);
56    }
57
58    /**
59     * Returns a copy with a new charsetNameOrDefault, preserving every other field.
60     */
61    public function withCharsetNameOrDefault(\SqlSemantics\Statement\Model\MySql\Role\CharsetNameOrDefaultForm $charsetNameOrDefault): self
62    {
63        return new self($this->charset, $charsetNameOrDefault, $this->optCollate, $this->comments);
64    }
65
66    /**
67     * Returns a copy with a new optCollate, preserving every other field.
68     */
69    public function withOptCollate(\SqlSemantics\Statement\Model\MySql\Role\OptCollateForm $optCollate): self
70    {
71        return new self($this->charset, $this->charsetNameOrDefault, $optCollate, $this->comments);
72    }
73
74    /**
75     * Returns a copy with a new comments, preserving every other field.
76     */
77    public function withComments(\SqlSemantics\Statement\Comments $comments): self
78    {
79        return new self($this->charset, $this->charsetNameOrDefault, $this->optCollate, $comments);
80    }
81}
82