packages/sql-semantics-postgres/resources/models/Value/FuncArgExprWithParamNameColonEqualsAExpr_16937048.php

1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\PostgreSql\Value;
6
7/**
8 * The func_arg_expr 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\PostgreSql\Value\FuncArgExprWithParamNameColonEqualsAExpr_16937048 $value): string => \SqlSemantics\Statement\Writer::render($value);
13 *     $write instanceof \Closure // => true
14 */
15final class FuncArgExprWithParamNameColonEqualsAExpr_16937048 implements \SqlSemantics\Statement\Model\PostgreSql\Role\FuncArgExprForm, \SqlSemantics\Statement\Model\PostgreSql\Role\FuncArgListForm, \SqlSemantics\Statement\Model\PostgreSql\Role\FuncArgListOptForm
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\PostgreSql\Role\ParamNameForm $paramName,
24        public readonly string $colonEquals,
25        public readonly \SqlSemantics\Statement\Model\PostgreSql\Role\AExprForm $aExpr,
26        public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
27    ) {
28        $this->assert(\SqlSemantics\Statement\Model\PostgreSql\Contract\Contracts::contains($paramName), 'The paramName must be a generated immutable SQL value.');
29        $this->assertMatchesPattern($colonEquals, \SqlSemantics\Statement\Model\PostgreSql\Contract\Contracts::SPELLINGS['COLON_EQUALS'], 'The colonEquals must be a complete COLON_EQUALS lexical spelling.');
30        $this->assert(\SqlSemantics\Statement\Model\PostgreSql\Contract\Contracts::contains($aExpr), 'The aExpr 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        $this->paramName->write($writer);
40        $writer->comments($this->comments, 1);
41        $writer->append($this->colonEquals);
42        $writer->comments($this->comments, 2);
43        $this->aExpr->write($writer);
44    }
45
46    /**
47     * Returns a copy with a new paramName, preserving every other field.
48     */
49    public function withParamName(\SqlSemantics\Statement\Model\PostgreSql\Role\ParamNameForm $paramName): self
50    {
51        return new self($paramName, $this->colonEquals, $this->aExpr, $this->comments);
52    }
53
54    /**
55     * Returns a copy with a new colonEquals, preserving every other field.
56     */
57    public function withColonEquals(string $colonEquals): self
58    {
59        return new self($this->paramName, $colonEquals, $this->aExpr, $this->comments);
60    }
61
62    /**
63     * Returns a copy with a new aExpr, preserving every other field.
64     */
65    public function withAExpr(\SqlSemantics\Statement\Model\PostgreSql\Role\AExprForm $aExpr): self
66    {
67        return new self($this->paramName, $this->colonEquals, $aExpr, $this->comments);
68    }
69
70    /**
71     * Returns a copy with a new comments, preserving every other field.
72     */
73    public function withComments(\SqlSemantics\Statement\Comments $comments): self
74    {
75        return new self($this->paramName, $this->colonEquals, $this->aExpr, $comments);
76    }
77}
78