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

1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\MySql\Value;
6
7/**
8 * The single_table_parens 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\SingleTableParensWithSingleTable_8e667bbf $value): string => \SqlSemantics\Statement\Writer::render($value);
13 *     $write instanceof \Closure // => true
14 */
15final class SingleTableParensWithSingleTable_8e667bbf implements \SqlSemantics\Statement\Model\MySql\Role\DerivedTableListForm, \SqlSemantics\Statement\Model\MySql\Role\EscTableRefForm, \SqlSemantics\Statement\Model\MySql\Role\EscTableReferenceForm, \SqlSemantics\Statement\Model\MySql\Role\FromTablesForm, \SqlSemantics\Statement\Model\MySql\Role\JoinTableListForm, \SqlSemantics\Statement\Model\MySql\Role\SelectDerivedForm, \SqlSemantics\Statement\Model\MySql\Role\SingleTableParensForm, \SqlSemantics\Statement\Model\MySql\Role\TableFactorForm, \SqlSemantics\Statement\Model\MySql\Role\TableRefForm, \SqlSemantics\Statement\Model\MySql\Role\TableReferenceForm, \SqlSemantics\Statement\Model\MySql\Role\TableReferenceListForm
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\SingleTableForm $singleTable,
24        public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
25    ) {
26        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($singleTable), 'The singleTable must be a generated immutable SQL value.');
27    }
28
29    /**
30     * Writes SQL entirely from this value's fields.
31     */
32    public function write(\SqlSemantics\Statement\Writer $writer): void
33    {
34        $writer->comments($this->comments, 0);
35        $writer->append('(');
36        $writer->comments($this->comments, 1);
37        $this->singleTable->write($writer);
38        $writer->comments($this->comments, 2);
39        $writer->append(')');
40    }
41
42    /**
43     * Returns a copy with a new singleTable, preserving every other field.
44     */
45    public function withSingleTable(\SqlSemantics\Statement\Model\MySql\Role\SingleTableForm $singleTable): self
46    {
47        return new self($singleTable, $this->comments);
48    }
49
50    /**
51     * Returns a copy with a new comments, preserving every other field.
52     */
53    public function withComments(\SqlSemantics\Statement\Comments $comments): self
54    {
55        return new self($this->singleTable, $comments);
56    }
57}
58