8bf4ecc026
- Adds `is_valid_unicode_identifier()` - Adds `is_valid_ascii_identifier()` - Deprecates `is_valid_identifier()` - Renames `validate_identifier()` to `validate_ascii_identifier()`
1404 lines
36 KiB
C++
1404 lines
36 KiB
C++
/**************************************************************************/
|
|
/* shader_preprocessor.cpp */
|
|
/**************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/**************************************************************************/
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/**************************************************************************/
|
|
|
|
#include "shader_preprocessor.h"
|
|
#include "core/math/expression.h"
|
|
|
|
const char32_t CURSOR = 0xFFFF;
|
|
|
|
// Tokenizer
|
|
|
|
void ShaderPreprocessor::Tokenizer::add_generated(const ShaderPreprocessor::Token &p_t) {
|
|
generated.push_back(p_t);
|
|
}
|
|
|
|
char32_t ShaderPreprocessor::Tokenizer::next() {
|
|
if (index < size) {
|
|
return code[index++];
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
int ShaderPreprocessor::Tokenizer::get_line() const {
|
|
return line;
|
|
}
|
|
|
|
int ShaderPreprocessor::Tokenizer::get_index() const {
|
|
return index;
|
|
}
|
|
|
|
void ShaderPreprocessor::Tokenizer::get_and_clear_generated(LocalVector<char32_t> *r_out) {
|
|
for (uint32_t i = 0; i < generated.size(); i++) {
|
|
r_out->push_back(generated[i].text);
|
|
}
|
|
generated.clear();
|
|
}
|
|
|
|
void ShaderPreprocessor::Tokenizer::backtrack(char32_t p_what) {
|
|
while (index >= 0) {
|
|
char32_t c = code[index];
|
|
if (c == p_what) {
|
|
break;
|
|
}
|
|
index--;
|
|
}
|
|
}
|
|
|
|
char32_t ShaderPreprocessor::Tokenizer::peek() {
|
|
if (index < size) {
|
|
return code[index];
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
int ShaderPreprocessor::Tokenizer::consume_line_continuations(int p_offset) {
|
|
int skips = 0;
|
|
|
|
for (int i = index + p_offset; i < size; i++) {
|
|
char32_t c = code[i];
|
|
if (c == '\\') {
|
|
if (i + 1 < size && code[i + 1] == '\n') {
|
|
// This line ends with "\" and "\n" continuation.
|
|
add_generated(Token('\n', line));
|
|
line++;
|
|
skips++;
|
|
|
|
i = i + 2;
|
|
index = i;
|
|
} else {
|
|
break;
|
|
}
|
|
} else if (!is_whitespace(c)) {
|
|
break;
|
|
}
|
|
}
|
|
return skips;
|
|
}
|
|
|
|
LocalVector<ShaderPreprocessor::Token> ShaderPreprocessor::Tokenizer::advance(char32_t p_what) {
|
|
LocalVector<ShaderPreprocessor::Token> tokens;
|
|
|
|
while (index < size) {
|
|
char32_t c = code[index++];
|
|
if (c == '\\' && consume_line_continuations(-1) > 0) {
|
|
continue;
|
|
}
|
|
|
|
if (c == '\n') {
|
|
add_generated(ShaderPreprocessor::Token('\n', line));
|
|
line++;
|
|
}
|
|
|
|
tokens.push_back(ShaderPreprocessor::Token(c, line));
|
|
|
|
if (c == p_what || c == 0) {
|
|
return tokens;
|
|
}
|
|
}
|
|
return LocalVector<ShaderPreprocessor::Token>();
|
|
}
|
|
|
|
void ShaderPreprocessor::Tokenizer::skip_whitespace() {
|
|
while (is_char_space(peek())) {
|
|
next();
|
|
}
|
|
}
|
|
|
|
bool ShaderPreprocessor::Tokenizer::consume_empty_line() {
|
|
// Read until newline and return true if the content was all whitespace/empty.
|
|
return tokens_to_string(advance('\n')).strip_edges().size() == 0;
|
|
}
|
|
|
|
String ShaderPreprocessor::Tokenizer::get_identifier(bool *r_is_cursor, bool p_started) {
|
|
if (r_is_cursor != nullptr) {
|
|
*r_is_cursor = false;
|
|
}
|
|
|
|
LocalVector<char32_t> text;
|
|
|
|
while (true) {
|
|
char32_t c = peek();
|
|
if (c == '\\' && consume_line_continuations(0) > 0) {
|
|
continue;
|
|
}
|
|
|
|
if (is_char_end(c) || c == '(' || c == ')' || c == ',' || c == ';') {
|
|
break;
|
|
}
|
|
|
|
if (is_whitespace(c) && p_started) {
|
|
break;
|
|
}
|
|
if (!is_whitespace(c)) {
|
|
p_started = true;
|
|
}
|
|
|
|
char32_t n = next();
|
|
if (n == CURSOR) {
|
|
if (r_is_cursor != nullptr) {
|
|
*r_is_cursor = true;
|
|
}
|
|
} else {
|
|
if (p_started) {
|
|
text.push_back(n);
|
|
}
|
|
}
|
|
}
|
|
|
|
String id = vector_to_string(text);
|
|
if (!id.is_valid_ascii_identifier()) {
|
|
return "";
|
|
}
|
|
|
|
return id;
|
|
}
|
|
|
|
String ShaderPreprocessor::Tokenizer::peek_identifier() {
|
|
const int original = index;
|
|
const int original_line = line;
|
|
String id = get_identifier();
|
|
index = original;
|
|
line = original_line;
|
|
return id;
|
|
}
|
|
|
|
ShaderPreprocessor::Token ShaderPreprocessor::Tokenizer::get_token() {
|
|
while (index < size) {
|
|
const char32_t c = code[index++];
|
|
const Token t = ShaderPreprocessor::Token(c, line);
|
|
|
|
switch (c) {
|
|
case ' ':
|
|
case '\t':
|
|
skip_whitespace();
|
|
return ShaderPreprocessor::Token(' ', line);
|
|
case '\n':
|
|
line++;
|
|
return t;
|
|
default:
|
|
return t;
|
|
}
|
|
}
|
|
return ShaderPreprocessor::Token(char32_t(0), line);
|
|
}
|
|
|
|
ShaderPreprocessor::Tokenizer::Tokenizer(const String &p_code) {
|
|
code = p_code;
|
|
line = 0;
|
|
index = 0;
|
|
size = code.size();
|
|
}
|
|
|
|
// ShaderPreprocessor::CommentRemover
|
|
|
|
String ShaderPreprocessor::CommentRemover::get_error() const {
|
|
if (comments_open != 0) {
|
|
return "Block comment mismatch";
|
|
}
|
|
return "";
|
|
}
|
|
|
|
int ShaderPreprocessor::CommentRemover::get_error_line() const {
|
|
if (comments_open != 0) {
|
|
return comment_line_open;
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
char32_t ShaderPreprocessor::CommentRemover::peek() const {
|
|
if (index < code.size()) {
|
|
return code[index];
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
bool ShaderPreprocessor::CommentRemover::advance(char32_t p_what) {
|
|
while (index < code.size()) {
|
|
char32_t c = code[index++];
|
|
|
|
if (c == '\n') {
|
|
line++;
|
|
stripped.push_back('\n');
|
|
}
|
|
|
|
if (c == p_what) {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
String ShaderPreprocessor::CommentRemover::strip() {
|
|
stripped.clear();
|
|
index = 0;
|
|
line = 0;
|
|
comment_line_open = 0;
|
|
comments_open = 0;
|
|
strings_open = 0;
|
|
|
|
while (index < code.size()) {
|
|
char32_t c = code[index++];
|
|
|
|
if (c == CURSOR) {
|
|
// Cursor. Maintain.
|
|
stripped.push_back(c);
|
|
} else if (c == '"') {
|
|
if (strings_open <= 0) {
|
|
strings_open++;
|
|
} else {
|
|
strings_open--;
|
|
}
|
|
stripped.push_back(c);
|
|
} else if (c == '/' && strings_open == 0) {
|
|
char32_t p = peek();
|
|
if (p == '/') { // Single line comment.
|
|
advance('\n');
|
|
} else if (p == '*') { // Start of a block comment.
|
|
index++;
|
|
comment_line_open = line;
|
|
comments_open++;
|
|
while (advance('*')) {
|
|
if (peek() == '/') { // End of a block comment.
|
|
comments_open--;
|
|
index++;
|
|
break;
|
|
}
|
|
}
|
|
} else {
|
|
stripped.push_back(c);
|
|
}
|
|
} else if (c == '*' && strings_open == 0) {
|
|
if (peek() == '/') { // Unmatched end of a block comment.
|
|
comment_line_open = line;
|
|
comments_open--;
|
|
} else {
|
|
stripped.push_back(c);
|
|
}
|
|
} else if (c == '\n') {
|
|
line++;
|
|
stripped.push_back(c);
|
|
} else {
|
|
stripped.push_back(c);
|
|
}
|
|
}
|
|
return vector_to_string(stripped);
|
|
}
|
|
|
|
ShaderPreprocessor::CommentRemover::CommentRemover(const String &p_code) {
|
|
code = p_code;
|
|
index = 0;
|
|
line = 0;
|
|
comment_line_open = 0;
|
|
comments_open = 0;
|
|
strings_open = 0;
|
|
}
|
|
|
|
// ShaderPreprocessor::Token
|
|
|
|
ShaderPreprocessor::Token::Token() {
|
|
text = 0;
|
|
line = -1;
|
|
}
|
|
|
|
ShaderPreprocessor::Token::Token(char32_t p_text, int p_line) {
|
|
text = p_text;
|
|
line = p_line;
|
|
}
|
|
|
|
// ShaderPreprocessor
|
|
|
|
bool ShaderPreprocessor::is_char_word(char32_t p_char) {
|
|
if ((p_char >= '0' && p_char <= '9') ||
|
|
(p_char >= 'a' && p_char <= 'z') ||
|
|
(p_char >= 'A' && p_char <= 'Z') ||
|
|
p_char == '_') {
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
bool ShaderPreprocessor::is_char_space(char32_t p_char) {
|
|
return p_char == ' ' || p_char == '\t';
|
|
}
|
|
|
|
bool ShaderPreprocessor::is_char_end(char32_t p_char) {
|
|
return p_char == '\n' || p_char == 0;
|
|
}
|
|
|
|
String ShaderPreprocessor::vector_to_string(const LocalVector<char32_t> &p_v, int p_start, int p_end) {
|
|
const int stop = (p_end == -1) ? p_v.size() : p_end;
|
|
const int count = stop - p_start;
|
|
|
|
String result;
|
|
result.resize(count + 1);
|
|
for (int i = 0; i < count; i++) {
|
|
result[i] = p_v[p_start + i];
|
|
}
|
|
result[count] = 0; // Ensure string is null terminated for length() to work.
|
|
return result;
|
|
}
|
|
|
|
String ShaderPreprocessor::tokens_to_string(const LocalVector<Token> &p_tokens) {
|
|
LocalVector<char32_t> result;
|
|
for (const Token &token : p_tokens) {
|
|
result.push_back(token.text);
|
|
}
|
|
return vector_to_string(result);
|
|
}
|
|
|
|
void ShaderPreprocessor::process_directive(Tokenizer *p_tokenizer) {
|
|
bool is_cursor;
|
|
String directive = p_tokenizer->get_identifier(&is_cursor, true);
|
|
if (is_cursor) {
|
|
state->completion_type = COMPLETION_TYPE_DIRECTIVE;
|
|
}
|
|
|
|
if (directive == "if") {
|
|
process_if(p_tokenizer);
|
|
} else if (directive == "ifdef") {
|
|
process_ifdef(p_tokenizer);
|
|
} else if (directive == "ifndef") {
|
|
process_ifndef(p_tokenizer);
|
|
} else if (directive == "elif") {
|
|
process_elif(p_tokenizer);
|
|
} else if (directive == "else") {
|
|
process_else(p_tokenizer);
|
|
} else if (directive == "endif") {
|
|
process_endif(p_tokenizer);
|
|
} else if (directive == "define") {
|
|
process_define(p_tokenizer);
|
|
} else if (directive == "undef") {
|
|
process_undef(p_tokenizer);
|
|
} else if (directive == "include") {
|
|
process_include(p_tokenizer);
|
|
} else if (directive == "pragma") {
|
|
process_pragma(p_tokenizer);
|
|
} else {
|
|
set_error(RTR("Unknown directive."), p_tokenizer->get_line());
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::process_define(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
String label = p_tokenizer->get_identifier();
|
|
if (label.is_empty()) {
|
|
set_error(RTR("Invalid macro name."), line);
|
|
return;
|
|
}
|
|
|
|
if (state->defines.has(label)) {
|
|
set_error(RTR("Macro redefinition."), line);
|
|
return;
|
|
}
|
|
|
|
Vector<String> args;
|
|
if (p_tokenizer->peek() == '(') {
|
|
// Macro has arguments.
|
|
p_tokenizer->get_token();
|
|
|
|
while (true) {
|
|
String name = p_tokenizer->get_identifier();
|
|
if (name.is_empty()) {
|
|
set_error(RTR("Invalid argument name."), line);
|
|
return;
|
|
}
|
|
args.push_back(name);
|
|
|
|
p_tokenizer->skip_whitespace();
|
|
char32_t next = p_tokenizer->get_token().text;
|
|
if (next == ')') {
|
|
break;
|
|
} else if (next != ',') {
|
|
set_error(RTR("Expected a comma in the macro argument list."), line);
|
|
return;
|
|
}
|
|
}
|
|
}
|
|
|
|
String body = tokens_to_string(p_tokenizer->advance('\n')).strip_edges();
|
|
if (body.begins_with("##")) {
|
|
set_error(RTR("'##' must not appear at beginning of macro expansion."), line);
|
|
return;
|
|
}
|
|
if (body.ends_with("##")) {
|
|
set_error(RTR("'##' must not appear at end of macro expansion."), line);
|
|
return;
|
|
}
|
|
|
|
Define *define = memnew(Define);
|
|
if (!args.is_empty()) {
|
|
define->arguments = args;
|
|
}
|
|
define->body = body;
|
|
state->defines[label] = define;
|
|
}
|
|
|
|
void ShaderPreprocessor::process_elif(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
if (state->current_branch == nullptr || state->current_branch->else_defined) {
|
|
set_error(RTR("Unmatched elif."), line);
|
|
return;
|
|
}
|
|
if (state->previous_region != nullptr) {
|
|
state->previous_region->to_line = line - 1;
|
|
}
|
|
|
|
String body = tokens_to_string(p_tokenizer->advance('\n')).strip_edges();
|
|
if (body.is_empty()) {
|
|
set_error(RTR("Missing condition."), line);
|
|
return;
|
|
}
|
|
|
|
Error error = expand_condition(body, line, body);
|
|
if (error != OK) {
|
|
return;
|
|
}
|
|
|
|
error = expand_macros(body, line, body);
|
|
if (error != OK) {
|
|
return;
|
|
}
|
|
|
|
Expression expression;
|
|
Vector<String> names;
|
|
error = expression.parse(body, names);
|
|
if (error != OK) {
|
|
set_error(expression.get_error_text(), line);
|
|
return;
|
|
}
|
|
|
|
Variant v = expression.execute(Array(), nullptr, false);
|
|
if (v.get_type() == Variant::NIL) {
|
|
set_error(RTR("Condition evaluation error."), line);
|
|
return;
|
|
}
|
|
|
|
bool skip = false;
|
|
for (int i = 0; i < state->current_branch->conditions.size(); i++) {
|
|
if (state->current_branch->conditions[i]) {
|
|
skip = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
bool success = !skip && v.booleanize();
|
|
start_branch_condition(p_tokenizer, success, true);
|
|
|
|
if (state->save_regions) {
|
|
add_region(line + 1, success, state->previous_region->parent);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::process_else(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
if (state->current_branch == nullptr || state->current_branch->else_defined) {
|
|
set_error(RTR("Unmatched else."), line);
|
|
return;
|
|
}
|
|
if (state->previous_region != nullptr) {
|
|
state->previous_region->to_line = line - 1;
|
|
}
|
|
|
|
if (!p_tokenizer->consume_empty_line()) {
|
|
set_error(RTR("Invalid else."), p_tokenizer->get_line());
|
|
}
|
|
|
|
bool skip = false;
|
|
for (int i = 0; i < state->current_branch->conditions.size(); i++) {
|
|
if (state->current_branch->conditions[i]) {
|
|
skip = true;
|
|
break;
|
|
}
|
|
}
|
|
state->current_branch->else_defined = true;
|
|
|
|
if (state->save_regions) {
|
|
add_region(line + 1, !skip, state->previous_region->parent);
|
|
}
|
|
|
|
if (skip) {
|
|
Vector<String> ends;
|
|
ends.push_back("endif");
|
|
next_directive(p_tokenizer, ends);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::process_endif(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
state->condition_depth--;
|
|
if (state->condition_depth < 0) {
|
|
set_error(RTR("Unmatched endif."), line);
|
|
return;
|
|
}
|
|
if (state->previous_region != nullptr) {
|
|
state->previous_region->to_line = line - 1;
|
|
state->previous_region = state->previous_region->parent;
|
|
}
|
|
|
|
if (!p_tokenizer->consume_empty_line()) {
|
|
set_error(RTR("Invalid endif."), line);
|
|
}
|
|
|
|
state->current_branch = state->current_branch->parent;
|
|
state->branches.pop_back();
|
|
}
|
|
|
|
void ShaderPreprocessor::process_if(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
String body = tokens_to_string(p_tokenizer->advance('\n')).strip_edges();
|
|
if (body.is_empty()) {
|
|
set_error(RTR("Missing condition."), line);
|
|
return;
|
|
}
|
|
|
|
Error error = expand_condition(body, line, body);
|
|
if (error != OK) {
|
|
return;
|
|
}
|
|
|
|
error = expand_macros(body, line, body);
|
|
if (error != OK) {
|
|
return;
|
|
}
|
|
|
|
Expression expression;
|
|
Vector<String> names;
|
|
error = expression.parse(body, names);
|
|
if (error != OK) {
|
|
set_error(expression.get_error_text(), line);
|
|
return;
|
|
}
|
|
|
|
Variant v = expression.execute(Array(), nullptr, false);
|
|
if (v.get_type() == Variant::NIL) {
|
|
set_error(RTR("Condition evaluation error."), line);
|
|
return;
|
|
}
|
|
|
|
bool success = v.booleanize();
|
|
start_branch_condition(p_tokenizer, success);
|
|
|
|
if (state->save_regions) {
|
|
add_region(line + 1, success, state->previous_region);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::process_ifdef(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
String label = p_tokenizer->get_identifier();
|
|
if (label.is_empty()) {
|
|
set_error(RTR("Invalid macro name."), line);
|
|
return;
|
|
}
|
|
|
|
if (!p_tokenizer->consume_empty_line()) {
|
|
set_error(RTR("Invalid ifdef."), line);
|
|
return;
|
|
}
|
|
|
|
bool success = state->defines.has(label);
|
|
start_branch_condition(p_tokenizer, success);
|
|
|
|
if (state->save_regions) {
|
|
add_region(line + 1, success, state->previous_region);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::process_ifndef(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
String label = p_tokenizer->get_identifier();
|
|
if (label.is_empty()) {
|
|
set_error(RTR("Invalid macro name."), line);
|
|
return;
|
|
}
|
|
|
|
if (!p_tokenizer->consume_empty_line()) {
|
|
set_error(RTR("Invalid ifndef."), line);
|
|
return;
|
|
}
|
|
|
|
bool success = !state->defines.has(label);
|
|
start_branch_condition(p_tokenizer, success);
|
|
|
|
if (state->save_regions) {
|
|
add_region(line + 1, success, state->previous_region);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::process_include(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
p_tokenizer->advance('"');
|
|
String path = tokens_to_string(p_tokenizer->advance('"'));
|
|
for (int i = 0; i < path.length(); i++) {
|
|
if (path[i] == '\n') {
|
|
break; //stop parsing
|
|
}
|
|
if (path[i] == CURSOR) {
|
|
state->completion_type = COMPLETION_TYPE_INCLUDE_PATH;
|
|
break;
|
|
}
|
|
}
|
|
path = path.substr(0, path.length() - 1);
|
|
|
|
if (path.is_empty() || !p_tokenizer->consume_empty_line()) {
|
|
set_error(RTR("Invalid path."), line);
|
|
return;
|
|
}
|
|
|
|
path = path.simplify_path();
|
|
if (path.is_relative_path()) {
|
|
path = state->current_filename.get_base_dir().path_join(path);
|
|
}
|
|
|
|
if (!ResourceLoader::exists(path)) {
|
|
set_error(RTR("Shader include file does not exist:") + " " + path, line);
|
|
return;
|
|
}
|
|
|
|
Ref<Resource> res = ResourceLoader::load(path);
|
|
if (res.is_null()) {
|
|
set_error(RTR("Shader include load failed. Does the shader include exist? Is there a cyclic dependency?"), line);
|
|
return;
|
|
}
|
|
|
|
Ref<ShaderInclude> shader_inc = res;
|
|
if (shader_inc.is_null()) {
|
|
set_error(RTR("Shader include resource type is wrong."), line);
|
|
return;
|
|
}
|
|
|
|
String included = shader_inc->get_code();
|
|
if (!included.is_empty()) {
|
|
uint64_t code_hash = included.hash64();
|
|
if (state->cyclic_include_hashes.find(code_hash)) {
|
|
set_error(RTR("Cyclic include found") + ": " + path, line);
|
|
return;
|
|
}
|
|
}
|
|
|
|
state->shader_includes.insert(shader_inc);
|
|
|
|
const String real_path = shader_inc->get_path();
|
|
if (state->includes.has(real_path)) {
|
|
// Already included, skip.
|
|
// This is a valid check because 2 separate include paths could use some
|
|
// of the same shared functions from a common shader include.
|
|
return;
|
|
}
|
|
|
|
// Mark as included.
|
|
state->includes.insert(real_path);
|
|
|
|
state->include_depth++;
|
|
if (state->include_depth > 25) {
|
|
set_error(RTR("Shader max include depth exceeded."), line);
|
|
return;
|
|
}
|
|
|
|
String old_filename = state->current_filename;
|
|
state->current_filename = real_path;
|
|
ShaderPreprocessor processor;
|
|
|
|
int prev_condition_depth = state->condition_depth;
|
|
state->condition_depth = 0;
|
|
|
|
FilePosition fp;
|
|
fp.file = state->current_filename;
|
|
fp.line = line + 1;
|
|
state->include_positions.push_back(fp);
|
|
|
|
String result;
|
|
processor.preprocess(state, included, result);
|
|
add_to_output("@@>" + real_path + "\n"); // Add token for enter include path
|
|
add_to_output(result);
|
|
add_to_output("\n@@<" + real_path + "\n"); // Add token for exit include path.
|
|
|
|
// Reset to last include if there are no errors. We want to use this as context.
|
|
if (state->error.is_empty()) {
|
|
state->current_filename = old_filename;
|
|
state->include_positions.pop_back();
|
|
} else {
|
|
return;
|
|
}
|
|
|
|
state->include_depth--;
|
|
state->condition_depth = prev_condition_depth;
|
|
}
|
|
|
|
void ShaderPreprocessor::process_pragma(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
|
|
bool is_cursor;
|
|
const String label = p_tokenizer->get_identifier(&is_cursor);
|
|
if (is_cursor) {
|
|
state->completion_type = COMPLETION_TYPE_PRAGMA;
|
|
}
|
|
|
|
if (label.is_empty()) {
|
|
set_error(RTR("Invalid pragma directive."), line);
|
|
return;
|
|
}
|
|
|
|
// Rxplicitly handle pragma values here.
|
|
// If more pragma options are created, then refactor into a more defined structure.
|
|
if (label == "disable_preprocessor") {
|
|
state->disabled = true;
|
|
} else {
|
|
set_error(RTR("Invalid pragma directive."), line);
|
|
return;
|
|
}
|
|
|
|
if (!p_tokenizer->consume_empty_line()) {
|
|
set_error(RTR("Invalid pragma directive."), line);
|
|
return;
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::process_undef(Tokenizer *p_tokenizer) {
|
|
const int line = p_tokenizer->get_line();
|
|
const String label = p_tokenizer->get_identifier();
|
|
if (label.is_empty() || !p_tokenizer->consume_empty_line()) {
|
|
set_error(RTR("Invalid undef."), line);
|
|
return;
|
|
}
|
|
|
|
if (state->defines.has(label)) {
|
|
memdelete(state->defines[label]);
|
|
state->defines.erase(label);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::add_region(int p_line, bool p_enabled, Region *p_parent_region) {
|
|
Region region;
|
|
region.file = state->current_filename;
|
|
region.enabled = p_enabled;
|
|
region.from_line = p_line;
|
|
region.parent = p_parent_region;
|
|
state->previous_region = &state->regions[region.file].push_back(region)->get();
|
|
}
|
|
|
|
void ShaderPreprocessor::start_branch_condition(Tokenizer *p_tokenizer, bool p_success, bool p_continue) {
|
|
if (!p_continue) {
|
|
state->condition_depth++;
|
|
state->current_branch = &state->branches.push_back(Branch(p_success, state->current_branch))->get();
|
|
} else {
|
|
state->current_branch->conditions.push_back(p_success);
|
|
}
|
|
if (!p_success) {
|
|
Vector<String> ends;
|
|
ends.push_back("elif");
|
|
ends.push_back("else");
|
|
ends.push_back("endif");
|
|
next_directive(p_tokenizer, ends);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::expand_output_macros(int p_start, int p_line_number) {
|
|
String line = vector_to_string(output, p_start, output.size());
|
|
|
|
Error error = expand_macros(line, p_line_number - 1, line); // We are already on next line, so -1.
|
|
if (error != OK) {
|
|
return;
|
|
}
|
|
|
|
output.resize(p_start);
|
|
|
|
add_to_output(line);
|
|
}
|
|
|
|
Error ShaderPreprocessor::expand_condition(const String &p_string, int p_line, String &r_expanded) {
|
|
// Checks bracket count to be even + check the cursor position.
|
|
{
|
|
int bracket_start_count = 0;
|
|
int bracket_end_count = 0;
|
|
|
|
for (int i = 0; i < p_string.size(); i++) {
|
|
switch (p_string[i]) {
|
|
case CURSOR:
|
|
state->completion_type = COMPLETION_TYPE_CONDITION;
|
|
break;
|
|
case '(':
|
|
bracket_start_count++;
|
|
break;
|
|
case ')':
|
|
bracket_end_count++;
|
|
break;
|
|
}
|
|
}
|
|
if (bracket_start_count > bracket_end_count) {
|
|
_set_expected_error(")", p_line);
|
|
return FAILED;
|
|
}
|
|
if (bracket_end_count > bracket_start_count) {
|
|
_set_expected_error("(", p_line);
|
|
return FAILED;
|
|
}
|
|
}
|
|
|
|
String result = p_string;
|
|
|
|
int index = 0;
|
|
int index_start = 0;
|
|
int index_end = 0;
|
|
|
|
while (find_match(result, "defined", index, index_start)) {
|
|
bool open_bracket = false;
|
|
bool found_word = false;
|
|
bool word_completed = false;
|
|
|
|
LocalVector<char32_t> text;
|
|
int post_bracket_index = -1;
|
|
int size = result.size();
|
|
|
|
for (int i = (index_start - 1); i < size; i++) {
|
|
char32_t c = result[i];
|
|
if (c == 0) {
|
|
if (found_word) {
|
|
word_completed = true;
|
|
}
|
|
break;
|
|
}
|
|
char32_t cs[] = { c, '\0' };
|
|
String s = String(cs);
|
|
bool is_space = is_char_space(c);
|
|
|
|
if (word_completed) {
|
|
if (c == ')') {
|
|
continue;
|
|
}
|
|
if (c == '|' || c == '&') {
|
|
if (open_bracket) {
|
|
_set_unexpected_token_error(s, p_line);
|
|
return FAILED;
|
|
}
|
|
break;
|
|
} else if (!is_space) {
|
|
_set_unexpected_token_error(s, p_line);
|
|
return FAILED;
|
|
}
|
|
} else if (is_space) {
|
|
if (found_word && !open_bracket) {
|
|
index_end = i;
|
|
word_completed = true;
|
|
}
|
|
} else if (c == '(') {
|
|
if (open_bracket) {
|
|
_set_unexpected_token_error(s, p_line);
|
|
return FAILED;
|
|
}
|
|
open_bracket = true;
|
|
} else if (c == ')') {
|
|
if (open_bracket) {
|
|
if (!found_word) {
|
|
_set_unexpected_token_error(s, p_line);
|
|
return FAILED;
|
|
}
|
|
open_bracket = false;
|
|
post_bracket_index = i + 1;
|
|
} else {
|
|
index_end = i;
|
|
}
|
|
word_completed = true;
|
|
} else if (is_char_word(c)) {
|
|
text.push_back(c);
|
|
found_word = true;
|
|
} else {
|
|
_set_unexpected_token_error(s, p_line);
|
|
return FAILED;
|
|
}
|
|
}
|
|
|
|
if (word_completed) {
|
|
if (open_bracket) {
|
|
_set_expected_error(")", p_line);
|
|
return FAILED;
|
|
}
|
|
if (post_bracket_index != -1) {
|
|
index_end = post_bracket_index;
|
|
}
|
|
|
|
String body = state->defines.has(vector_to_string(text)) ? "true" : "false";
|
|
String temp = result;
|
|
|
|
result = result.substr(0, index) + body;
|
|
index_start = result.length();
|
|
if (index_end > 0) {
|
|
result += temp.substr(index_end);
|
|
}
|
|
} else {
|
|
set_error(RTR("Invalid macro name."), p_line);
|
|
return FAILED;
|
|
}
|
|
}
|
|
r_expanded = result;
|
|
return OK;
|
|
}
|
|
|
|
Error ShaderPreprocessor::expand_macros(const String &p_string, int p_line, String &r_expanded) {
|
|
String iterative = p_string;
|
|
int pass_count = 0;
|
|
bool expanded = true;
|
|
|
|
while (expanded) {
|
|
expanded = false;
|
|
|
|
// As long as we find something to expand, keep going.
|
|
for (const RBMap<String, Define *>::Element *E = state->defines.front(); E; E = E->next()) {
|
|
if (expand_macros_once(iterative, p_line, E, iterative)) {
|
|
expanded = true;
|
|
}
|
|
}
|
|
|
|
pass_count++;
|
|
if (pass_count > 50) {
|
|
set_error(RTR("Macro expansion limit exceeded."), p_line);
|
|
break;
|
|
}
|
|
}
|
|
|
|
r_expanded = iterative;
|
|
|
|
if (!state->error.is_empty()) {
|
|
return FAILED;
|
|
}
|
|
return OK;
|
|
}
|
|
|
|
bool ShaderPreprocessor::expand_macros_once(const String &p_line, int p_line_number, const RBMap<String, Define *>::Element *p_define_pair, String &r_expanded) {
|
|
String result = p_line;
|
|
|
|
const String &key = p_define_pair->key();
|
|
const Define *define = p_define_pair->value();
|
|
|
|
int index_start = 0;
|
|
int index = 0;
|
|
if (find_match(result, key, index, index_start)) {
|
|
String body = define->body;
|
|
if (define->arguments.size() > 0) {
|
|
// Complex macro with arguments.
|
|
|
|
int args_start = -1;
|
|
int args_end = -1;
|
|
int brackets_open = 0;
|
|
Vector<String> args;
|
|
for (int i = index_start - 1; i < p_line.length(); i++) {
|
|
bool add_argument = false;
|
|
bool reached_end = false;
|
|
char32_t c = p_line[i];
|
|
|
|
if (c == '(') {
|
|
brackets_open++;
|
|
if (brackets_open == 1) {
|
|
args_start = i + 1;
|
|
args_end = -1;
|
|
}
|
|
} else if (c == ')') {
|
|
brackets_open--;
|
|
if (brackets_open == 0) {
|
|
args_end = i;
|
|
add_argument = true;
|
|
reached_end = true;
|
|
}
|
|
} else if (c == ',') {
|
|
if (brackets_open == 1) {
|
|
args_end = i;
|
|
add_argument = true;
|
|
}
|
|
}
|
|
|
|
if (add_argument) {
|
|
if (args_start == -1 || args_end == -1) {
|
|
set_error(RTR("Invalid macro argument list."), p_line_number);
|
|
return false;
|
|
}
|
|
|
|
String arg = p_line.substr(args_start, args_end - args_start).strip_edges();
|
|
if (arg.is_empty()) {
|
|
set_error(RTR("Invalid macro argument."), p_line_number);
|
|
return false;
|
|
}
|
|
args.append(arg);
|
|
|
|
args_start = args_end + 1;
|
|
}
|
|
|
|
if (reached_end) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (args.size() != define->arguments.size()) {
|
|
set_error(RTR("Invalid macro argument count."), p_line_number);
|
|
return false;
|
|
}
|
|
|
|
// Insert macro arguments into the body.
|
|
for (int i = 0; i < args.size(); i++) {
|
|
String arg_name = define->arguments[i];
|
|
int arg_index_start = 0;
|
|
int arg_index = 0;
|
|
while (find_match(body, arg_name, arg_index, arg_index_start)) {
|
|
body = body.substr(0, arg_index) + args[i] + body.substr(arg_index + arg_name.length(), body.length() - (arg_index + arg_name.length()));
|
|
// Manually reset arg_index_start to where the arg value of the define finishes.
|
|
// This ensures we don't skip the other args of this macro in the string.
|
|
arg_index_start = arg_index + args[i].length() + 1;
|
|
}
|
|
}
|
|
|
|
concatenate_macro_body(body);
|
|
|
|
result = result.substr(0, index) + " " + body + " " + result.substr(args_end + 1, result.length());
|
|
} else {
|
|
concatenate_macro_body(body);
|
|
|
|
result = result.substr(0, index) + " " + body + " " + result.substr(index + key.length(), result.length() - (index + key.length()));
|
|
}
|
|
|
|
r_expanded = result;
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
bool ShaderPreprocessor::find_match(const String &p_string, const String &p_value, int &r_index, int &r_index_start) {
|
|
// Looks for value in string and then determines if the boundaries
|
|
// are non-word characters. This method semi-emulates \b in regex.
|
|
r_index = p_string.find(p_value, r_index_start);
|
|
while (r_index > -1) {
|
|
if (r_index > 0) {
|
|
if (is_char_word(p_string[r_index - 1])) {
|
|
r_index_start = r_index + 1;
|
|
r_index = p_string.find(p_value, r_index_start);
|
|
continue;
|
|
}
|
|
}
|
|
|
|
if (r_index + p_value.length() < p_string.length()) {
|
|
if (is_char_word(p_string[r_index + p_value.length()])) {
|
|
r_index_start = r_index + p_value.length() + 1;
|
|
r_index = p_string.find(p_value, r_index_start);
|
|
continue;
|
|
}
|
|
}
|
|
|
|
// Return and shift index start automatically for next call.
|
|
r_index_start = r_index + p_value.length() + 1;
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
void ShaderPreprocessor::concatenate_macro_body(String &r_body) {
|
|
int index_start = r_body.find("##");
|
|
while (index_start > -1) {
|
|
int index_end = index_start + 2; // First character after ##.
|
|
// The macro was checked during creation so this should never happen.
|
|
ERR_FAIL_INDEX(index_end, r_body.size());
|
|
|
|
// If there more than two # in a row, then it's not a concatenation.
|
|
bool is_concat = true;
|
|
while (index_end <= r_body.length() && r_body[index_end] == '#') {
|
|
index_end++;
|
|
is_concat = false;
|
|
}
|
|
if (!is_concat) {
|
|
index_start = r_body.find("##", index_end);
|
|
continue;
|
|
}
|
|
|
|
// Skip whitespace after ##.
|
|
while (index_end < r_body.length() && is_char_space(r_body[index_end])) {
|
|
index_end++;
|
|
}
|
|
|
|
// Skip whitespace before ##.
|
|
while (index_start >= 1 && is_char_space(r_body[index_start - 1])) {
|
|
index_start--;
|
|
}
|
|
|
|
r_body = r_body.substr(0, index_start) + r_body.substr(index_end, r_body.length() - index_end);
|
|
|
|
index_start = r_body.find("##", index_start);
|
|
}
|
|
}
|
|
|
|
String ShaderPreprocessor::next_directive(Tokenizer *p_tokenizer, const Vector<String> &p_directives) {
|
|
const int line = p_tokenizer->get_line();
|
|
int nesting = 0;
|
|
|
|
while (true) {
|
|
p_tokenizer->advance('#');
|
|
|
|
String id = p_tokenizer->peek_identifier();
|
|
if (id.is_empty()) {
|
|
break;
|
|
}
|
|
|
|
if (nesting == 0) {
|
|
for (int i = 0; i < p_directives.size(); i++) {
|
|
if (p_directives[i] == id) {
|
|
p_tokenizer->backtrack('#');
|
|
return id;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (id == "ifdef" || id == "ifndef" || id == "if") {
|
|
nesting++;
|
|
} else if (id == "endif") {
|
|
nesting--;
|
|
}
|
|
}
|
|
|
|
set_error(RTR("Can't find matching branch directive."), line);
|
|
return "";
|
|
}
|
|
|
|
void ShaderPreprocessor::add_to_output(const String &p_str) {
|
|
for (int i = 0; i < p_str.length(); i++) {
|
|
output.push_back(p_str[i]);
|
|
}
|
|
}
|
|
|
|
void ShaderPreprocessor::set_error(const String &p_error, int p_line) {
|
|
if (state->error.is_empty()) {
|
|
state->error = p_error;
|
|
FilePosition fp;
|
|
fp.file = state->current_filename;
|
|
fp.line = p_line + 1;
|
|
state->include_positions.push_back(fp);
|
|
}
|
|
}
|
|
|
|
ShaderPreprocessor::Define *ShaderPreprocessor::create_define(const String &p_body) {
|
|
ShaderPreprocessor::Define *define = memnew(Define);
|
|
define->body = p_body;
|
|
return define;
|
|
}
|
|
|
|
void ShaderPreprocessor::clear_state() {
|
|
if (state != nullptr) {
|
|
for (const RBMap<String, Define *>::Element *E = state->defines.front(); E; E = E->next()) {
|
|
memdelete(E->get());
|
|
}
|
|
state->defines.clear();
|
|
}
|
|
state = nullptr;
|
|
}
|
|
|
|
Error ShaderPreprocessor::preprocess(State *p_state, const String &p_code, String &r_result) {
|
|
output.clear();
|
|
|
|
state = p_state;
|
|
|
|
CommentRemover remover(p_code);
|
|
String stripped = remover.strip();
|
|
String error = remover.get_error();
|
|
if (!error.is_empty()) {
|
|
set_error(error, remover.get_error_line());
|
|
return FAILED;
|
|
}
|
|
|
|
// Track code hashes to prevent cyclic include.
|
|
uint64_t code_hash = p_code.hash64();
|
|
state->cyclic_include_hashes.push_back(code_hash);
|
|
|
|
Tokenizer p_tokenizer(stripped);
|
|
int last_size = 0;
|
|
bool has_symbols_before_directive = false;
|
|
|
|
while (true) {
|
|
const Token &t = p_tokenizer.get_token();
|
|
|
|
if (t.text == 0) {
|
|
break;
|
|
}
|
|
|
|
// Add autogenerated tokens if there are any.
|
|
p_tokenizer.get_and_clear_generated(&output);
|
|
|
|
if (state->disabled) {
|
|
// Preprocessor was disabled.
|
|
// Read the rest of the file into the output.
|
|
output.push_back(t.text);
|
|
continue;
|
|
}
|
|
|
|
if (t.text == '#') {
|
|
if (has_symbols_before_directive) {
|
|
set_error(RTR("Invalid symbols placed before directive."), p_tokenizer.get_line());
|
|
state->cyclic_include_hashes.erase(code_hash); // Remove this hash.
|
|
return FAILED;
|
|
}
|
|
process_directive(&p_tokenizer);
|
|
} else {
|
|
if (is_char_end(t.text)) {
|
|
expand_output_macros(last_size, p_tokenizer.get_line());
|
|
last_size = output.size();
|
|
has_symbols_before_directive = false;
|
|
} else if (!is_char_space(t.text)) {
|
|
has_symbols_before_directive = true;
|
|
}
|
|
output.push_back(t.text);
|
|
}
|
|
|
|
if (!state->error.is_empty()) {
|
|
state->cyclic_include_hashes.erase(code_hash); // Remove this hash.
|
|
return FAILED;
|
|
}
|
|
}
|
|
state->cyclic_include_hashes.erase(code_hash); // Remove this hash.
|
|
|
|
if (!state->disabled) {
|
|
if (state->condition_depth != 0) {
|
|
set_error(RTR("Unmatched conditional statement."), p_tokenizer.line);
|
|
return FAILED;
|
|
}
|
|
|
|
expand_output_macros(last_size, p_tokenizer.get_line());
|
|
}
|
|
|
|
r_result = vector_to_string(output);
|
|
|
|
return OK;
|
|
}
|
|
|
|
Error ShaderPreprocessor::preprocess(const String &p_code, const String &p_filename, String &r_result, String *r_error_text, List<FilePosition> *r_error_position, List<Region> *r_regions, HashSet<Ref<ShaderInclude>> *r_includes, List<ScriptLanguage::CodeCompletionOption> *r_completion_options, List<ScriptLanguage::CodeCompletionOption> *r_completion_defines, IncludeCompletionFunction p_include_completion_func) {
|
|
State pp_state;
|
|
if (!p_filename.is_empty()) {
|
|
pp_state.current_filename = p_filename;
|
|
pp_state.save_regions = r_regions != nullptr;
|
|
}
|
|
Error err = preprocess(&pp_state, p_code, r_result);
|
|
if (err != OK) {
|
|
if (r_error_text) {
|
|
*r_error_text = pp_state.error;
|
|
}
|
|
if (r_error_position) {
|
|
*r_error_position = pp_state.include_positions;
|
|
}
|
|
}
|
|
if (r_regions) {
|
|
*r_regions = pp_state.regions[p_filename];
|
|
}
|
|
if (r_includes) {
|
|
*r_includes = pp_state.shader_includes;
|
|
}
|
|
|
|
if (r_completion_defines) {
|
|
for (const KeyValue<String, Define *> &E : state->defines) {
|
|
ScriptLanguage::CodeCompletionOption option(E.key, ScriptLanguage::CODE_COMPLETION_KIND_CONSTANT);
|
|
r_completion_defines->push_back(option);
|
|
}
|
|
}
|
|
|
|
if (r_completion_options) {
|
|
switch (pp_state.completion_type) {
|
|
case COMPLETION_TYPE_DIRECTIVE: {
|
|
List<String> options;
|
|
get_keyword_list(&options, true, true);
|
|
|
|
for (const String &E : options) {
|
|
ScriptLanguage::CodeCompletionOption option(E, ScriptLanguage::CODE_COMPLETION_KIND_PLAIN_TEXT);
|
|
r_completion_options->push_back(option);
|
|
}
|
|
|
|
} break;
|
|
case COMPLETION_TYPE_PRAGMA: {
|
|
List<String> options;
|
|
ShaderPreprocessor::get_pragma_list(&options);
|
|
|
|
for (const String &E : options) {
|
|
ScriptLanguage::CodeCompletionOption option(E, ScriptLanguage::CODE_COMPLETION_KIND_PLAIN_TEXT);
|
|
r_completion_options->push_back(option);
|
|
}
|
|
|
|
} break;
|
|
case COMPLETION_TYPE_CONDITION: {
|
|
ScriptLanguage::CodeCompletionOption option("defined", ScriptLanguage::CODE_COMPLETION_KIND_PLAIN_TEXT);
|
|
r_completion_options->push_back(option);
|
|
|
|
} break;
|
|
case COMPLETION_TYPE_INCLUDE_PATH: {
|
|
if (p_include_completion_func && r_completion_options) {
|
|
p_include_completion_func(r_completion_options);
|
|
}
|
|
|
|
} break;
|
|
default: {
|
|
}
|
|
}
|
|
}
|
|
|
|
clear_state();
|
|
|
|
return err;
|
|
}
|
|
|
|
void ShaderPreprocessor::get_keyword_list(List<String> *r_keywords, bool p_include_shader_keywords, bool p_ignore_context_keywords) {
|
|
r_keywords->push_back("define");
|
|
if (!p_ignore_context_keywords) {
|
|
r_keywords->push_back("defined");
|
|
}
|
|
r_keywords->push_back("elif");
|
|
if (p_include_shader_keywords) {
|
|
r_keywords->push_back("else");
|
|
}
|
|
r_keywords->push_back("endif");
|
|
if (p_include_shader_keywords) {
|
|
r_keywords->push_back("if");
|
|
}
|
|
r_keywords->push_back("ifdef");
|
|
r_keywords->push_back("ifndef");
|
|
r_keywords->push_back("include");
|
|
r_keywords->push_back("pragma");
|
|
r_keywords->push_back("undef");
|
|
}
|
|
|
|
void ShaderPreprocessor::get_pragma_list(List<String> *r_pragmas) {
|
|
r_pragmas->push_back("disable_preprocessor");
|
|
}
|
|
|
|
ShaderPreprocessor::ShaderPreprocessor() {
|
|
}
|
|
|
|
ShaderPreprocessor::~ShaderPreprocessor() {
|
|
}
|