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

1<?php
2
3declare(strict_types=1);
4
5namespace SqlSemantics\Statement\Model\MySql\Value;
6
7/**
8 * The show_databases_stmt 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\ShowDatabasesStmtWithShowDatabasesOptWildOrWhere_d28dc5dc $value): string => \SqlSemantics\Statement\Writer::render($value);
13 *     $write instanceof \Closure // => true
14 */
15final class ShowDatabasesStmtWithShowDatabasesOptWildOrWhere_d28dc5dc implements \SqlSemantics\Statement\Model\MySql\Role\EvSqlStmtForm, \SqlSemantics\Statement\Model\MySql\Role\EvSqlStmtInnerForm, \SqlSemantics\Statement\Model\MySql\Role\ShowDatabasesStmtForm, \SqlSemantics\Statement\Model\MySql\Role\SimpleStatementForm, \SqlSemantics\Statement\Model\MySql\Role\SimpleStatementOrBeginForm, \SqlSemantics\Statement\Model\MySql\Role\SpProcStmtForm, \SqlSemantics\Statement\Model\MySql\Role\SpProcStmtStatementForm, \SqlSemantics\Statement\Model\MySql\Role\StoredRoutineBodyForm, \SqlSemantics\Statement\Command
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 string $databases,
24        public readonly \SqlSemantics\Statement\Model\MySql\Role\OptWildOrWhereForm $optWildOrWhere,
25        public readonly \SqlSemantics\Statement\Comments $comments = new \SqlSemantics\Statement\Comments(),
26    ) {
27        $this->assertMatchesPattern($databases, \SqlSemantics\Statement\Model\MySql\Contract\Contracts::SPELLINGS['DATABASES'], 'The databases must be a complete DATABASES lexical spelling.');
28        $this->assert(\SqlSemantics\Statement\Model\MySql\Contract\Contracts::contains($optWildOrWhere), 'The optWildOrWhere must be a generated immutable SQL value.');
29    }
30
31    /**
32     * Writes SQL entirely from this value's fields.
33     */
34    public function write(\SqlSemantics\Statement\Writer $writer): void
35    {
36        $writer->comments($this->comments, 0);
37        $writer->append('SHOW');
38        $writer->comments($this->comments, 1);
39        $writer->append($this->databases);
40        $writer->comments($this->comments, 2);
41        $this->optWildOrWhere->write($writer);
42    }
43
44    /**
45     * Returns a copy with a new databases, preserving every other field.
46     */
47    public function withDatabases(string $databases): self
48    {
49        return new self($databases, $this->optWildOrWhere, $this->comments);
50    }
51
52    /**
53     * Returns a copy with a new optWildOrWhere, preserving every other field.
54     */
55    public function withOptWildOrWhere(\SqlSemantics\Statement\Model\MySql\Role\OptWildOrWhereForm $optWildOrWhere): self
56    {
57        return new self($this->databases, $optWildOrWhere, $this->comments);
58    }
59
60    /**
61     * Returns a copy with a new comments, preserving every other field.
62     */
63    public function withComments(\SqlSemantics\Statement\Comments $comments): self
64    {
65        return new self($this->databases, $this->optWildOrWhere, $comments);
66    }
67}
68