variant_parser.cpp 51 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004
  1. /*************************************************************************/
  2. /* variant_parser.cpp */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /*************************************************************************/
  30. #include "variant_parser.h"
  31. #include "core/input/input_event.h"
  32. #include "core/io/resource_loader.h"
  33. #include "core/os/keyboard.h"
  34. #include "core/string/string_buffer.h"
  35. char32_t VariantParser::Stream::get_char() {
  36. // is within buffer?
  37. if (readahead_pointer < readahead_filled) {
  38. return readahead_buffer[readahead_pointer++];
  39. }
  40. // attempt to readahead
  41. readahead_filled = _read_buffer(readahead_buffer, READAHEAD_SIZE);
  42. if (readahead_filled) {
  43. readahead_pointer = 0;
  44. } else {
  45. // EOF
  46. readahead_pointer = 1;
  47. eof = true;
  48. return 0;
  49. }
  50. return get_char();
  51. }
  52. bool VariantParser::StreamFile::is_utf8() const {
  53. return true;
  54. }
  55. uint32_t VariantParser::StreamFile::_read_buffer(char32_t *p_buffer, uint32_t p_num_chars) {
  56. // The buffer is assumed to include at least one character (for null terminator)
  57. ERR_FAIL_COND_V(!p_num_chars, 0);
  58. uint8_t *temp = (uint8_t *)alloca(p_num_chars);
  59. uint64_t num_read = f->get_buffer(temp, p_num_chars);
  60. ERR_FAIL_COND_V(num_read == UINT64_MAX, 0);
  61. // translate to wchar
  62. for (uint32_t n = 0; n < num_read; n++) {
  63. p_buffer[n] = temp[n];
  64. }
  65. // could be less than p_num_chars, or zero
  66. return num_read;
  67. }
  68. bool VariantParser::StreamString::is_utf8() const {
  69. return false;
  70. }
  71. uint32_t VariantParser::StreamString::_read_buffer(char32_t *p_buffer, uint32_t p_num_chars) {
  72. // The buffer is assumed to include at least one character (for null terminator)
  73. ERR_FAIL_COND_V(!p_num_chars, 0);
  74. int available = MAX(s.length() - pos, 0);
  75. if (available >= (int)p_num_chars) {
  76. const char32_t *src = s.ptr();
  77. src += pos;
  78. memcpy(p_buffer, src, p_num_chars * sizeof(char32_t));
  79. pos += p_num_chars;
  80. return p_num_chars;
  81. }
  82. // going to reach EOF
  83. if (available) {
  84. const char32_t *src = s.ptr();
  85. src += pos;
  86. memcpy(p_buffer, src, available * sizeof(char32_t));
  87. pos += available;
  88. }
  89. // add a zero
  90. p_buffer[available] = 0;
  91. return available;
  92. }
  93. /////////////////////////////////////////////////////////////////////////////////////////////////
  94. const char *VariantParser::tk_name[TK_MAX] = {
  95. "'{'",
  96. "'}'",
  97. "'['",
  98. "']'",
  99. "'('",
  100. "')'",
  101. "identifier",
  102. "string",
  103. "string_name",
  104. "number",
  105. "color",
  106. "':'",
  107. "','",
  108. "'.'",
  109. "'='",
  110. "EOF",
  111. "ERROR"
  112. };
  113. static double stor_fix(const String &p_str) {
  114. if (p_str == "inf") {
  115. return INFINITY;
  116. } else if (p_str == "inf_neg") {
  117. return -INFINITY;
  118. } else if (p_str == "nan") {
  119. return NAN;
  120. }
  121. return -1;
  122. }
  123. Error VariantParser::get_token(Stream *p_stream, Token &r_token, int &line, String &r_err_str) {
  124. bool string_name = false;
  125. while (true) {
  126. char32_t cchar;
  127. if (p_stream->saved) {
  128. cchar = p_stream->saved;
  129. p_stream->saved = 0;
  130. } else {
  131. cchar = p_stream->get_char();
  132. if (p_stream->is_eof()) {
  133. r_token.type = TK_EOF;
  134. return OK;
  135. }
  136. }
  137. switch (cchar) {
  138. case '\n': {
  139. line++;
  140. break;
  141. }
  142. case 0: {
  143. r_token.type = TK_EOF;
  144. return OK;
  145. } break;
  146. case '{': {
  147. r_token.type = TK_CURLY_BRACKET_OPEN;
  148. return OK;
  149. }
  150. case '}': {
  151. r_token.type = TK_CURLY_BRACKET_CLOSE;
  152. return OK;
  153. }
  154. case '[': {
  155. r_token.type = TK_BRACKET_OPEN;
  156. return OK;
  157. }
  158. case ']': {
  159. r_token.type = TK_BRACKET_CLOSE;
  160. return OK;
  161. }
  162. case '(': {
  163. r_token.type = TK_PARENTHESIS_OPEN;
  164. return OK;
  165. }
  166. case ')': {
  167. r_token.type = TK_PARENTHESIS_CLOSE;
  168. return OK;
  169. }
  170. case ':': {
  171. r_token.type = TK_COLON;
  172. return OK;
  173. }
  174. case ';': {
  175. while (true) {
  176. char32_t ch = p_stream->get_char();
  177. if (p_stream->is_eof()) {
  178. r_token.type = TK_EOF;
  179. return OK;
  180. }
  181. if (ch == '\n') {
  182. line++;
  183. break;
  184. }
  185. }
  186. break;
  187. }
  188. case ',': {
  189. r_token.type = TK_COMMA;
  190. return OK;
  191. }
  192. case '.': {
  193. r_token.type = TK_PERIOD;
  194. return OK;
  195. }
  196. case '=': {
  197. r_token.type = TK_EQUAL;
  198. return OK;
  199. }
  200. case '#': {
  201. StringBuffer<> color_str;
  202. color_str += '#';
  203. while (true) {
  204. char32_t ch = p_stream->get_char();
  205. if (p_stream->is_eof()) {
  206. r_token.type = TK_EOF;
  207. return OK;
  208. } else if (is_hex_digit(ch)) {
  209. color_str += ch;
  210. } else {
  211. p_stream->saved = ch;
  212. break;
  213. }
  214. }
  215. r_token.value = Color::html(color_str.as_string());
  216. r_token.type = TK_COLOR;
  217. return OK;
  218. }
  219. #ifndef DISABLE_DEPRECATED
  220. case '@': // Compatibility with 3.x StringNames.
  221. #endif
  222. case '&': { // StringName.
  223. cchar = p_stream->get_char();
  224. if (cchar != '"') {
  225. r_err_str = "Expected '\"' after '&'";
  226. r_token.type = TK_ERROR;
  227. return ERR_PARSE_ERROR;
  228. }
  229. string_name = true;
  230. [[fallthrough]];
  231. }
  232. case '"': {
  233. String str;
  234. char32_t prev = 0;
  235. while (true) {
  236. char32_t ch = p_stream->get_char();
  237. if (ch == 0) {
  238. r_err_str = "Unterminated String";
  239. r_token.type = TK_ERROR;
  240. return ERR_PARSE_ERROR;
  241. } else if (ch == '"') {
  242. break;
  243. } else if (ch == '\\') {
  244. //escaped characters...
  245. char32_t next = p_stream->get_char();
  246. if (next == 0) {
  247. r_err_str = "Unterminated String";
  248. r_token.type = TK_ERROR;
  249. return ERR_PARSE_ERROR;
  250. }
  251. char32_t res = 0;
  252. switch (next) {
  253. case 'b':
  254. res = 8;
  255. break;
  256. case 't':
  257. res = 9;
  258. break;
  259. case 'n':
  260. res = 10;
  261. break;
  262. case 'f':
  263. res = 12;
  264. break;
  265. case 'r':
  266. res = 13;
  267. break;
  268. case 'U':
  269. case 'u': {
  270. // Hexadecimal sequence.
  271. int hex_len = (next == 'U') ? 6 : 4;
  272. for (int j = 0; j < hex_len; j++) {
  273. char32_t c = p_stream->get_char();
  274. if (c == 0) {
  275. r_err_str = "Unterminated String";
  276. r_token.type = TK_ERROR;
  277. return ERR_PARSE_ERROR;
  278. }
  279. if (!is_hex_digit(c)) {
  280. r_err_str = "Malformed hex constant in string";
  281. r_token.type = TK_ERROR;
  282. return ERR_PARSE_ERROR;
  283. }
  284. char32_t v;
  285. if (is_digit(c)) {
  286. v = c - '0';
  287. } else if (c >= 'a' && c <= 'f') {
  288. v = c - 'a';
  289. v += 10;
  290. } else if (c >= 'A' && c <= 'F') {
  291. v = c - 'A';
  292. v += 10;
  293. } else {
  294. ERR_PRINT("Bug parsing hex constant.");
  295. v = 0;
  296. }
  297. res <<= 4;
  298. res |= v;
  299. }
  300. } break;
  301. default: {
  302. res = next;
  303. } break;
  304. }
  305. // Parse UTF-16 pair.
  306. if ((res & 0xfffffc00) == 0xd800) {
  307. if (prev == 0) {
  308. prev = res;
  309. continue;
  310. } else {
  311. r_err_str = "Invalid UTF-16 sequence in string, unpaired lead surrogate";
  312. r_token.type = TK_ERROR;
  313. return ERR_PARSE_ERROR;
  314. }
  315. } else if ((res & 0xfffffc00) == 0xdc00) {
  316. if (prev == 0) {
  317. r_err_str = "Invalid UTF-16 sequence in string, unpaired trail surrogate";
  318. r_token.type = TK_ERROR;
  319. return ERR_PARSE_ERROR;
  320. } else {
  321. res = (prev << 10UL) + res - ((0xd800 << 10UL) + 0xdc00 - 0x10000);
  322. prev = 0;
  323. }
  324. }
  325. if (prev != 0) {
  326. r_err_str = "Invalid UTF-16 sequence in string, unpaired lead surrogate";
  327. r_token.type = TK_ERROR;
  328. return ERR_PARSE_ERROR;
  329. }
  330. str += res;
  331. } else {
  332. if (prev != 0) {
  333. r_err_str = "Invalid UTF-16 sequence in string, unpaired lead surrogate";
  334. r_token.type = TK_ERROR;
  335. return ERR_PARSE_ERROR;
  336. }
  337. if (ch == '\n') {
  338. line++;
  339. }
  340. str += ch;
  341. }
  342. }
  343. if (prev != 0) {
  344. r_err_str = "Invalid UTF-16 sequence in string, unpaired lead surrogate";
  345. r_token.type = TK_ERROR;
  346. return ERR_PARSE_ERROR;
  347. }
  348. if (p_stream->is_utf8()) {
  349. str.parse_utf8(str.ascii(true).get_data());
  350. }
  351. if (string_name) {
  352. r_token.type = TK_STRING_NAME;
  353. r_token.value = StringName(str);
  354. } else {
  355. r_token.type = TK_STRING;
  356. r_token.value = str;
  357. }
  358. return OK;
  359. } break;
  360. default: {
  361. if (cchar <= 32) {
  362. break;
  363. }
  364. if (cchar == '-' || (cchar >= '0' && cchar <= '9')) {
  365. //a number
  366. StringBuffer<> num;
  367. #define READING_SIGN 0
  368. #define READING_INT 1
  369. #define READING_DEC 2
  370. #define READING_EXP 3
  371. #define READING_DONE 4
  372. int reading = READING_INT;
  373. if (cchar == '-') {
  374. num += '-';
  375. cchar = p_stream->get_char();
  376. }
  377. char32_t c = cchar;
  378. bool exp_sign = false;
  379. bool exp_beg = false;
  380. bool is_float = false;
  381. while (true) {
  382. switch (reading) {
  383. case READING_INT: {
  384. if (is_digit(c)) {
  385. //pass
  386. } else if (c == '.') {
  387. reading = READING_DEC;
  388. is_float = true;
  389. } else if (c == 'e') {
  390. reading = READING_EXP;
  391. is_float = true;
  392. } else {
  393. reading = READING_DONE;
  394. }
  395. } break;
  396. case READING_DEC: {
  397. if (is_digit(c)) {
  398. } else if (c == 'e') {
  399. reading = READING_EXP;
  400. } else {
  401. reading = READING_DONE;
  402. }
  403. } break;
  404. case READING_EXP: {
  405. if (is_digit(c)) {
  406. exp_beg = true;
  407. } else if ((c == '-' || c == '+') && !exp_sign && !exp_beg) {
  408. exp_sign = true;
  409. } else {
  410. reading = READING_DONE;
  411. }
  412. } break;
  413. }
  414. if (reading == READING_DONE) {
  415. break;
  416. }
  417. num += c;
  418. c = p_stream->get_char();
  419. }
  420. p_stream->saved = c;
  421. r_token.type = TK_NUMBER;
  422. if (is_float) {
  423. r_token.value = num.as_double();
  424. } else {
  425. r_token.value = num.as_int();
  426. }
  427. return OK;
  428. } else if (is_ascii_char(cchar) || is_underscore(cchar)) {
  429. StringBuffer<> id;
  430. bool first = true;
  431. while (is_ascii_char(cchar) || is_underscore(cchar) || (!first && is_digit(cchar))) {
  432. id += cchar;
  433. cchar = p_stream->get_char();
  434. first = false;
  435. }
  436. p_stream->saved = cchar;
  437. r_token.type = TK_IDENTIFIER;
  438. r_token.value = id.as_string();
  439. return OK;
  440. } else {
  441. r_err_str = "Unexpected character.";
  442. r_token.type = TK_ERROR;
  443. return ERR_PARSE_ERROR;
  444. }
  445. }
  446. }
  447. }
  448. r_token.type = TK_ERROR;
  449. return ERR_PARSE_ERROR;
  450. }
  451. Error VariantParser::_parse_enginecfg(Stream *p_stream, Vector<String> &strings, int &line, String &r_err_str) {
  452. Token token;
  453. get_token(p_stream, token, line, r_err_str);
  454. if (token.type != TK_PARENTHESIS_OPEN) {
  455. r_err_str = "Expected '(' in old-style project.godot construct";
  456. return ERR_PARSE_ERROR;
  457. }
  458. String accum;
  459. while (true) {
  460. char32_t c = p_stream->get_char();
  461. if (p_stream->is_eof()) {
  462. r_err_str = "Unexpected EOF while parsing old-style project.godot construct";
  463. return ERR_PARSE_ERROR;
  464. }
  465. if (c == ',') {
  466. strings.push_back(accum.strip_edges());
  467. accum = String();
  468. } else if (c == ')') {
  469. strings.push_back(accum.strip_edges());
  470. return OK;
  471. } else if (c == '\n') {
  472. line++;
  473. }
  474. }
  475. }
  476. template <class T>
  477. Error VariantParser::_parse_construct(Stream *p_stream, Vector<T> &r_construct, int &line, String &r_err_str) {
  478. Token token;
  479. get_token(p_stream, token, line, r_err_str);
  480. if (token.type != TK_PARENTHESIS_OPEN) {
  481. r_err_str = "Expected '(' in constructor";
  482. return ERR_PARSE_ERROR;
  483. }
  484. bool first = true;
  485. while (true) {
  486. if (!first) {
  487. get_token(p_stream, token, line, r_err_str);
  488. if (token.type == TK_COMMA) {
  489. //do none
  490. } else if (token.type == TK_PARENTHESIS_CLOSE) {
  491. break;
  492. } else {
  493. r_err_str = "Expected ',' or ')' in constructor";
  494. return ERR_PARSE_ERROR;
  495. }
  496. }
  497. get_token(p_stream, token, line, r_err_str);
  498. if (first && token.type == TK_PARENTHESIS_CLOSE) {
  499. break;
  500. } else if (token.type != TK_NUMBER) {
  501. bool valid = false;
  502. if (token.type == TK_IDENTIFIER) {
  503. double real = stor_fix(token.value);
  504. if (real != -1) {
  505. token.type = TK_NUMBER;
  506. token.value = real;
  507. valid = true;
  508. }
  509. }
  510. if (!valid) {
  511. r_err_str = "Expected float in constructor";
  512. return ERR_PARSE_ERROR;
  513. }
  514. }
  515. r_construct.push_back(token.value);
  516. first = false;
  517. }
  518. return OK;
  519. }
  520. Error VariantParser::parse_value(Token &token, Variant &value, Stream *p_stream, int &line, String &r_err_str, ResourceParser *p_res_parser) {
  521. if (token.type == TK_CURLY_BRACKET_OPEN) {
  522. Dictionary d;
  523. Error err = _parse_dictionary(d, p_stream, line, r_err_str, p_res_parser);
  524. if (err) {
  525. return err;
  526. }
  527. value = d;
  528. return OK;
  529. } else if (token.type == TK_BRACKET_OPEN) {
  530. Array a;
  531. Error err = _parse_array(a, p_stream, line, r_err_str, p_res_parser);
  532. if (err) {
  533. return err;
  534. }
  535. value = a;
  536. return OK;
  537. } else if (token.type == TK_IDENTIFIER) {
  538. String id = token.value;
  539. if (id == "true") {
  540. value = true;
  541. } else if (id == "false") {
  542. value = false;
  543. } else if (id == "null" || id == "nil") {
  544. value = Variant();
  545. } else if (id == "inf") {
  546. value = INFINITY;
  547. } else if (id == "inf_neg") {
  548. value = -INFINITY;
  549. } else if (id == "nan") {
  550. value = NAN;
  551. } else if (id == "Vector2") {
  552. Vector<real_t> args;
  553. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  554. if (err) {
  555. return err;
  556. }
  557. if (args.size() != 2) {
  558. r_err_str = "Expected 2 arguments for constructor";
  559. return ERR_PARSE_ERROR;
  560. }
  561. value = Vector2(args[0], args[1]);
  562. } else if (id == "Vector2i") {
  563. Vector<int32_t> args;
  564. Error err = _parse_construct<int32_t>(p_stream, args, line, r_err_str);
  565. if (err) {
  566. return err;
  567. }
  568. if (args.size() != 2) {
  569. r_err_str = "Expected 2 arguments for constructor";
  570. return ERR_PARSE_ERROR;
  571. }
  572. value = Vector2i(args[0], args[1]);
  573. } else if (id == "Rect2") {
  574. Vector<real_t> args;
  575. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  576. if (err) {
  577. return err;
  578. }
  579. if (args.size() != 4) {
  580. r_err_str = "Expected 4 arguments for constructor";
  581. return ERR_PARSE_ERROR;
  582. }
  583. value = Rect2(args[0], args[1], args[2], args[3]);
  584. } else if (id == "Rect2i") {
  585. Vector<int32_t> args;
  586. Error err = _parse_construct<int32_t>(p_stream, args, line, r_err_str);
  587. if (err) {
  588. return err;
  589. }
  590. if (args.size() != 4) {
  591. r_err_str = "Expected 4 arguments for constructor";
  592. return ERR_PARSE_ERROR;
  593. }
  594. value = Rect2i(args[0], args[1], args[2], args[3]);
  595. } else if (id == "Vector3") {
  596. Vector<real_t> args;
  597. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  598. if (err) {
  599. return err;
  600. }
  601. if (args.size() != 3) {
  602. r_err_str = "Expected 3 arguments for constructor";
  603. return ERR_PARSE_ERROR;
  604. }
  605. value = Vector3(args[0], args[1], args[2]);
  606. } else if (id == "Vector3i") {
  607. Vector<int32_t> args;
  608. Error err = _parse_construct<int32_t>(p_stream, args, line, r_err_str);
  609. if (err) {
  610. return err;
  611. }
  612. if (args.size() != 3) {
  613. r_err_str = "Expected 3 arguments for constructor";
  614. return ERR_PARSE_ERROR;
  615. }
  616. value = Vector3i(args[0], args[1], args[2]);
  617. } else if (id == "Vector4") {
  618. Vector<real_t> args;
  619. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  620. if (err) {
  621. return err;
  622. }
  623. if (args.size() != 4) {
  624. r_err_str = "Expected 4 arguments for constructor";
  625. return ERR_PARSE_ERROR;
  626. }
  627. value = Vector4(args[0], args[1], args[2], args[3]);
  628. } else if (id == "Vector4i") {
  629. Vector<int32_t> args;
  630. Error err = _parse_construct<int32_t>(p_stream, args, line, r_err_str);
  631. if (err) {
  632. return err;
  633. }
  634. if (args.size() != 4) {
  635. r_err_str = "Expected 4 arguments for constructor";
  636. return ERR_PARSE_ERROR;
  637. }
  638. value = Vector4i(args[0], args[1], args[2], args[3]);
  639. } else if (id == "Transform2D" || id == "Matrix32") { //compatibility
  640. Vector<real_t> args;
  641. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  642. if (err) {
  643. return err;
  644. }
  645. if (args.size() != 6) {
  646. r_err_str = "Expected 6 arguments for constructor";
  647. return ERR_PARSE_ERROR;
  648. }
  649. Transform2D m;
  650. m[0] = Vector2(args[0], args[1]);
  651. m[1] = Vector2(args[2], args[3]);
  652. m[2] = Vector2(args[4], args[5]);
  653. value = m;
  654. } else if (id == "Plane") {
  655. Vector<real_t> args;
  656. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  657. if (err) {
  658. return err;
  659. }
  660. if (args.size() != 4) {
  661. r_err_str = "Expected 4 arguments for constructor";
  662. return ERR_PARSE_ERROR;
  663. }
  664. value = Plane(args[0], args[1], args[2], args[3]);
  665. } else if (id == "Quaternion" || id == "Quat") { // "Quat" kept for compatibility
  666. Vector<real_t> args;
  667. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  668. if (err) {
  669. return err;
  670. }
  671. if (args.size() != 4) {
  672. r_err_str = "Expected 4 arguments for constructor";
  673. return ERR_PARSE_ERROR;
  674. }
  675. value = Quaternion(args[0], args[1], args[2], args[3]);
  676. } else if (id == "AABB" || id == "Rect3") {
  677. Vector<real_t> args;
  678. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  679. if (err) {
  680. return err;
  681. }
  682. if (args.size() != 6) {
  683. r_err_str = "Expected 6 arguments for constructor";
  684. return ERR_PARSE_ERROR;
  685. }
  686. value = AABB(Vector3(args[0], args[1], args[2]), Vector3(args[3], args[4], args[5]));
  687. } else if (id == "Basis" || id == "Matrix3") { //compatibility
  688. Vector<real_t> args;
  689. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  690. if (err) {
  691. return err;
  692. }
  693. if (args.size() != 9) {
  694. r_err_str = "Expected 9 arguments for constructor";
  695. return ERR_PARSE_ERROR;
  696. }
  697. value = Basis(args[0], args[1], args[2], args[3], args[4], args[5], args[6], args[7], args[8]);
  698. } else if (id == "Transform3D" || id == "Transform") { // "Transform" kept for compatibility with Godot <4.
  699. Vector<real_t> args;
  700. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  701. if (err) {
  702. return err;
  703. }
  704. if (args.size() != 12) {
  705. r_err_str = "Expected 12 arguments for constructor";
  706. return ERR_PARSE_ERROR;
  707. }
  708. value = Transform3D(Basis(args[0], args[1], args[2], args[3], args[4], args[5], args[6], args[7], args[8]), Vector3(args[9], args[10], args[11]));
  709. } else if (id == "Projection") { // "Transform" kept for compatibility with Godot <4.
  710. Vector<real_t> args;
  711. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  712. if (err) {
  713. return err;
  714. }
  715. if (args.size() != 16) {
  716. r_err_str = "Expected 16 arguments for constructor";
  717. return ERR_PARSE_ERROR;
  718. }
  719. value = Projection(Vector4(args[0], args[1], args[2], args[3]), Vector4(args[4], args[5], args[6], args[7]), Vector4(args[8], args[9], args[10], args[11]), Vector4(args[12], args[13], args[14], args[15]));
  720. } else if (id == "Color") {
  721. Vector<float> args;
  722. Error err = _parse_construct<float>(p_stream, args, line, r_err_str);
  723. if (err) {
  724. return err;
  725. }
  726. if (args.size() != 4) {
  727. r_err_str = "Expected 4 arguments for constructor";
  728. return ERR_PARSE_ERROR;
  729. }
  730. value = Color(args[0], args[1], args[2], args[3]);
  731. } else if (id == "NodePath") {
  732. get_token(p_stream, token, line, r_err_str);
  733. if (token.type != TK_PARENTHESIS_OPEN) {
  734. r_err_str = "Expected '('";
  735. return ERR_PARSE_ERROR;
  736. }
  737. get_token(p_stream, token, line, r_err_str);
  738. if (token.type != TK_STRING) {
  739. r_err_str = "Expected string as argument for NodePath()";
  740. return ERR_PARSE_ERROR;
  741. }
  742. value = NodePath(String(token.value));
  743. get_token(p_stream, token, line, r_err_str);
  744. if (token.type != TK_PARENTHESIS_CLOSE) {
  745. r_err_str = "Expected ')'";
  746. return ERR_PARSE_ERROR;
  747. }
  748. } else if (id == "RID") {
  749. get_token(p_stream, token, line, r_err_str);
  750. if (token.type != TK_PARENTHESIS_OPEN) {
  751. r_err_str = "Expected '('";
  752. return ERR_PARSE_ERROR;
  753. }
  754. get_token(p_stream, token, line, r_err_str);
  755. if (token.type != TK_NUMBER) {
  756. r_err_str = "Expected number as argument";
  757. return ERR_PARSE_ERROR;
  758. }
  759. value = token.value;
  760. get_token(p_stream, token, line, r_err_str);
  761. if (token.type != TK_PARENTHESIS_CLOSE) {
  762. r_err_str = "Expected ')'";
  763. return ERR_PARSE_ERROR;
  764. }
  765. } else if (id == "Object") {
  766. get_token(p_stream, token, line, r_err_str);
  767. if (token.type != TK_PARENTHESIS_OPEN) {
  768. r_err_str = "Expected '('";
  769. return ERR_PARSE_ERROR;
  770. }
  771. get_token(p_stream, token, line, r_err_str);
  772. if (token.type != TK_IDENTIFIER) {
  773. r_err_str = "Expected identifier with type of object";
  774. return ERR_PARSE_ERROR;
  775. }
  776. String type = token.value;
  777. Object *obj = ClassDB::instantiate(type);
  778. if (!obj) {
  779. r_err_str = "Can't instantiate Object() of type: " + type;
  780. return ERR_PARSE_ERROR;
  781. }
  782. Ref<RefCounted> ref = Ref<RefCounted>(Object::cast_to<RefCounted>(obj));
  783. get_token(p_stream, token, line, r_err_str);
  784. if (token.type != TK_COMMA) {
  785. r_err_str = "Expected ',' after object type";
  786. return ERR_PARSE_ERROR;
  787. }
  788. bool at_key = true;
  789. String key;
  790. Token token2;
  791. bool need_comma = false;
  792. while (true) {
  793. if (p_stream->is_eof()) {
  794. r_err_str = "Unexpected End of File while parsing Object()";
  795. return ERR_FILE_CORRUPT;
  796. }
  797. if (at_key) {
  798. Error err = get_token(p_stream, token2, line, r_err_str);
  799. if (err != OK) {
  800. return err;
  801. }
  802. if (token2.type == TK_PARENTHESIS_CLOSE) {
  803. value = ref.is_valid() ? Variant(ref) : Variant(obj);
  804. return OK;
  805. }
  806. if (need_comma) {
  807. if (token2.type != TK_COMMA) {
  808. r_err_str = "Expected '}' or ','";
  809. return ERR_PARSE_ERROR;
  810. } else {
  811. need_comma = false;
  812. continue;
  813. }
  814. }
  815. if (token2.type != TK_STRING) {
  816. r_err_str = "Expected property name as string";
  817. return ERR_PARSE_ERROR;
  818. }
  819. key = token2.value;
  820. err = get_token(p_stream, token2, line, r_err_str);
  821. if (err != OK) {
  822. return err;
  823. }
  824. if (token2.type != TK_COLON) {
  825. r_err_str = "Expected ':'";
  826. return ERR_PARSE_ERROR;
  827. }
  828. at_key = false;
  829. } else {
  830. Error err = get_token(p_stream, token2, line, r_err_str);
  831. if (err != OK) {
  832. return err;
  833. }
  834. Variant v;
  835. err = parse_value(token2, v, p_stream, line, r_err_str, p_res_parser);
  836. if (err) {
  837. return err;
  838. }
  839. obj->set(key, v);
  840. need_comma = true;
  841. at_key = true;
  842. }
  843. }
  844. } else if (id == "Resource" || id == "SubResource" || id == "ExtResource") {
  845. get_token(p_stream, token, line, r_err_str);
  846. if (token.type != TK_PARENTHESIS_OPEN) {
  847. r_err_str = "Expected '('";
  848. return ERR_PARSE_ERROR;
  849. }
  850. if (p_res_parser && id == "Resource" && p_res_parser->func) {
  851. Ref<Resource> res;
  852. Error err = p_res_parser->func(p_res_parser->userdata, p_stream, res, line, r_err_str);
  853. if (err) {
  854. return err;
  855. }
  856. value = res;
  857. } else if (p_res_parser && id == "ExtResource" && p_res_parser->ext_func) {
  858. Ref<Resource> res;
  859. Error err = p_res_parser->ext_func(p_res_parser->userdata, p_stream, res, line, r_err_str);
  860. if (err) {
  861. return err;
  862. }
  863. value = res;
  864. } else if (p_res_parser && id == "SubResource" && p_res_parser->sub_func) {
  865. Ref<Resource> res;
  866. Error err = p_res_parser->sub_func(p_res_parser->userdata, p_stream, res, line, r_err_str);
  867. if (err) {
  868. return err;
  869. }
  870. value = res;
  871. } else {
  872. get_token(p_stream, token, line, r_err_str);
  873. if (token.type == TK_STRING) {
  874. String path = token.value;
  875. Ref<Resource> res = ResourceLoader::load(path);
  876. if (res.is_null()) {
  877. r_err_str = "Can't load resource at path: '" + path + "'.";
  878. return ERR_PARSE_ERROR;
  879. }
  880. get_token(p_stream, token, line, r_err_str);
  881. if (token.type != TK_PARENTHESIS_CLOSE) {
  882. r_err_str = "Expected ')'";
  883. return ERR_PARSE_ERROR;
  884. }
  885. value = res;
  886. } else {
  887. r_err_str = "Expected string as argument for Resource().";
  888. return ERR_PARSE_ERROR;
  889. }
  890. }
  891. } else if (id == "PackedByteArray" || id == "PoolByteArray" || id == "ByteArray") {
  892. Vector<uint8_t> args;
  893. Error err = _parse_construct<uint8_t>(p_stream, args, line, r_err_str);
  894. if (err) {
  895. return err;
  896. }
  897. Vector<uint8_t> arr;
  898. {
  899. int len = args.size();
  900. arr.resize(len);
  901. uint8_t *w = arr.ptrw();
  902. for (int i = 0; i < len; i++) {
  903. w[i] = args[i];
  904. }
  905. }
  906. value = arr;
  907. } else if (id == "PackedInt32Array" || id == "PackedIntArray" || id == "PoolIntArray" || id == "IntArray") {
  908. Vector<int32_t> args;
  909. Error err = _parse_construct<int32_t>(p_stream, args, line, r_err_str);
  910. if (err) {
  911. return err;
  912. }
  913. Vector<int32_t> arr;
  914. {
  915. int32_t len = args.size();
  916. arr.resize(len);
  917. int32_t *w = arr.ptrw();
  918. for (int32_t i = 0; i < len; i++) {
  919. w[i] = int32_t(args[i]);
  920. }
  921. }
  922. value = arr;
  923. } else if (id == "PackedInt64Array") {
  924. Vector<int64_t> args;
  925. Error err = _parse_construct<int64_t>(p_stream, args, line, r_err_str);
  926. if (err) {
  927. return err;
  928. }
  929. Vector<int64_t> arr;
  930. {
  931. int64_t len = args.size();
  932. arr.resize(len);
  933. int64_t *w = arr.ptrw();
  934. for (int64_t i = 0; i < len; i++) {
  935. w[i] = int64_t(args[i]);
  936. }
  937. }
  938. value = arr;
  939. } else if (id == "PackedFloat32Array" || id == "PackedRealArray" || id == "PoolRealArray" || id == "FloatArray") {
  940. Vector<float> args;
  941. Error err = _parse_construct<float>(p_stream, args, line, r_err_str);
  942. if (err) {
  943. return err;
  944. }
  945. Vector<float> arr;
  946. {
  947. int len = args.size();
  948. arr.resize(len);
  949. float *w = arr.ptrw();
  950. for (int i = 0; i < len; i++) {
  951. w[i] = args[i];
  952. }
  953. }
  954. value = arr;
  955. } else if (id == "PackedFloat64Array") {
  956. Vector<double> args;
  957. Error err = _parse_construct<double>(p_stream, args, line, r_err_str);
  958. if (err) {
  959. return err;
  960. }
  961. Vector<double> arr;
  962. {
  963. int len = args.size();
  964. arr.resize(len);
  965. double *w = arr.ptrw();
  966. for (int i = 0; i < len; i++) {
  967. w[i] = args[i];
  968. }
  969. }
  970. value = arr;
  971. } else if (id == "PackedStringArray" || id == "PoolStringArray" || id == "StringArray") {
  972. get_token(p_stream, token, line, r_err_str);
  973. if (token.type != TK_PARENTHESIS_OPEN) {
  974. r_err_str = "Expected '('";
  975. return ERR_PARSE_ERROR;
  976. }
  977. Vector<String> cs;
  978. bool first = true;
  979. while (true) {
  980. if (!first) {
  981. get_token(p_stream, token, line, r_err_str);
  982. if (token.type == TK_COMMA) {
  983. //do none
  984. } else if (token.type == TK_PARENTHESIS_CLOSE) {
  985. break;
  986. } else {
  987. r_err_str = "Expected ',' or ')'";
  988. return ERR_PARSE_ERROR;
  989. }
  990. }
  991. get_token(p_stream, token, line, r_err_str);
  992. if (token.type == TK_PARENTHESIS_CLOSE) {
  993. break;
  994. } else if (token.type != TK_STRING) {
  995. r_err_str = "Expected string";
  996. return ERR_PARSE_ERROR;
  997. }
  998. first = false;
  999. cs.push_back(token.value);
  1000. }
  1001. Vector<String> arr;
  1002. {
  1003. int len = cs.size();
  1004. arr.resize(len);
  1005. String *w = arr.ptrw();
  1006. for (int i = 0; i < len; i++) {
  1007. w[i] = cs[i];
  1008. }
  1009. }
  1010. value = arr;
  1011. } else if (id == "PackedVector2Array" || id == "PoolVector2Array" || id == "Vector2Array") {
  1012. Vector<real_t> args;
  1013. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  1014. if (err) {
  1015. return err;
  1016. }
  1017. Vector<Vector2> arr;
  1018. {
  1019. int len = args.size() / 2;
  1020. arr.resize(len);
  1021. Vector2 *w = arr.ptrw();
  1022. for (int i = 0; i < len; i++) {
  1023. w[i] = Vector2(args[i * 2 + 0], args[i * 2 + 1]);
  1024. }
  1025. }
  1026. value = arr;
  1027. } else if (id == "PackedVector3Array" || id == "PoolVector3Array" || id == "Vector3Array") {
  1028. Vector<real_t> args;
  1029. Error err = _parse_construct<real_t>(p_stream, args, line, r_err_str);
  1030. if (err) {
  1031. return err;
  1032. }
  1033. Vector<Vector3> arr;
  1034. {
  1035. int len = args.size() / 3;
  1036. arr.resize(len);
  1037. Vector3 *w = arr.ptrw();
  1038. for (int i = 0; i < len; i++) {
  1039. w[i] = Vector3(args[i * 3 + 0], args[i * 3 + 1], args[i * 3 + 2]);
  1040. }
  1041. }
  1042. value = arr;
  1043. } else if (id == "PackedColorArray" || id == "PoolColorArray" || id == "ColorArray") {
  1044. Vector<float> args;
  1045. Error err = _parse_construct<float>(p_stream, args, line, r_err_str);
  1046. if (err) {
  1047. return err;
  1048. }
  1049. Vector<Color> arr;
  1050. {
  1051. int len = args.size() / 4;
  1052. arr.resize(len);
  1053. Color *w = arr.ptrw();
  1054. for (int i = 0; i < len; i++) {
  1055. w[i] = Color(args[i * 4 + 0], args[i * 4 + 1], args[i * 4 + 2], args[i * 4 + 3]);
  1056. }
  1057. }
  1058. value = arr;
  1059. } else {
  1060. r_err_str = "Unexpected identifier: '" + id + "'.";
  1061. return ERR_PARSE_ERROR;
  1062. }
  1063. // All above branches end up here unless they had an early return.
  1064. return OK;
  1065. } else if (token.type == TK_NUMBER) {
  1066. value = token.value;
  1067. return OK;
  1068. } else if (token.type == TK_STRING) {
  1069. value = token.value;
  1070. return OK;
  1071. } else if (token.type == TK_STRING_NAME) {
  1072. value = token.value;
  1073. return OK;
  1074. } else if (token.type == TK_COLOR) {
  1075. value = token.value;
  1076. return OK;
  1077. } else {
  1078. r_err_str = "Expected value, got " + String(tk_name[token.type]) + ".";
  1079. return ERR_PARSE_ERROR;
  1080. }
  1081. }
  1082. Error VariantParser::_parse_array(Array &array, Stream *p_stream, int &line, String &r_err_str, ResourceParser *p_res_parser) {
  1083. Token token;
  1084. bool need_comma = false;
  1085. while (true) {
  1086. if (p_stream->is_eof()) {
  1087. r_err_str = "Unexpected End of File while parsing array";
  1088. return ERR_FILE_CORRUPT;
  1089. }
  1090. Error err = get_token(p_stream, token, line, r_err_str);
  1091. if (err != OK) {
  1092. return err;
  1093. }
  1094. if (token.type == TK_BRACKET_CLOSE) {
  1095. return OK;
  1096. }
  1097. if (need_comma) {
  1098. if (token.type != TK_COMMA) {
  1099. r_err_str = "Expected ','";
  1100. return ERR_PARSE_ERROR;
  1101. } else {
  1102. need_comma = false;
  1103. continue;
  1104. }
  1105. }
  1106. Variant v;
  1107. err = parse_value(token, v, p_stream, line, r_err_str, p_res_parser);
  1108. if (err) {
  1109. return err;
  1110. }
  1111. array.push_back(v);
  1112. need_comma = true;
  1113. }
  1114. }
  1115. Error VariantParser::_parse_dictionary(Dictionary &object, Stream *p_stream, int &line, String &r_err_str, ResourceParser *p_res_parser) {
  1116. bool at_key = true;
  1117. Variant key;
  1118. Token token;
  1119. bool need_comma = false;
  1120. while (true) {
  1121. if (p_stream->is_eof()) {
  1122. r_err_str = "Unexpected End of File while parsing dictionary";
  1123. return ERR_FILE_CORRUPT;
  1124. }
  1125. if (at_key) {
  1126. Error err = get_token(p_stream, token, line, r_err_str);
  1127. if (err != OK) {
  1128. return err;
  1129. }
  1130. if (token.type == TK_CURLY_BRACKET_CLOSE) {
  1131. return OK;
  1132. }
  1133. if (need_comma) {
  1134. if (token.type != TK_COMMA) {
  1135. r_err_str = "Expected '}' or ','";
  1136. return ERR_PARSE_ERROR;
  1137. } else {
  1138. need_comma = false;
  1139. continue;
  1140. }
  1141. }
  1142. err = parse_value(token, key, p_stream, line, r_err_str, p_res_parser);
  1143. if (err) {
  1144. return err;
  1145. }
  1146. err = get_token(p_stream, token, line, r_err_str);
  1147. if (err != OK) {
  1148. return err;
  1149. }
  1150. if (token.type != TK_COLON) {
  1151. r_err_str = "Expected ':'";
  1152. return ERR_PARSE_ERROR;
  1153. }
  1154. at_key = false;
  1155. } else {
  1156. Error err = get_token(p_stream, token, line, r_err_str);
  1157. if (err != OK) {
  1158. return err;
  1159. }
  1160. Variant v;
  1161. err = parse_value(token, v, p_stream, line, r_err_str, p_res_parser);
  1162. if (err && err != ERR_FILE_MISSING_DEPENDENCIES) {
  1163. return err;
  1164. }
  1165. object[key] = v;
  1166. need_comma = true;
  1167. at_key = true;
  1168. }
  1169. }
  1170. }
  1171. Error VariantParser::_parse_tag(Token &token, Stream *p_stream, int &line, String &r_err_str, Tag &r_tag, ResourceParser *p_res_parser, bool p_simple_tag) {
  1172. r_tag.fields.clear();
  1173. if (token.type != TK_BRACKET_OPEN) {
  1174. r_err_str = "Expected '['";
  1175. return ERR_PARSE_ERROR;
  1176. }
  1177. if (p_simple_tag) {
  1178. r_tag.name = "";
  1179. r_tag.fields.clear();
  1180. if (p_stream->is_utf8()) {
  1181. CharString cs;
  1182. while (true) {
  1183. char c = p_stream->get_char();
  1184. if (p_stream->is_eof()) {
  1185. r_err_str = "Unexpected EOF while parsing simple tag";
  1186. return ERR_PARSE_ERROR;
  1187. }
  1188. if (c == ']') {
  1189. break;
  1190. }
  1191. cs += c;
  1192. }
  1193. r_tag.name.parse_utf8(cs.get_data(), cs.length());
  1194. } else {
  1195. while (true) {
  1196. char32_t c = p_stream->get_char();
  1197. if (p_stream->is_eof()) {
  1198. r_err_str = "Unexpected EOF while parsing simple tag";
  1199. return ERR_PARSE_ERROR;
  1200. }
  1201. if (c == ']') {
  1202. break;
  1203. }
  1204. r_tag.name += String::chr(c);
  1205. }
  1206. }
  1207. r_tag.name = r_tag.name.strip_edges();
  1208. return OK;
  1209. }
  1210. get_token(p_stream, token, line, r_err_str);
  1211. if (token.type != TK_IDENTIFIER) {
  1212. r_err_str = "Expected identifier (tag name)";
  1213. return ERR_PARSE_ERROR;
  1214. }
  1215. r_tag.name = token.value;
  1216. bool parsing_tag = true;
  1217. while (true) {
  1218. if (p_stream->is_eof()) {
  1219. r_err_str = "Unexpected End of File while parsing tag: " + r_tag.name;
  1220. return ERR_FILE_CORRUPT;
  1221. }
  1222. get_token(p_stream, token, line, r_err_str);
  1223. if (token.type == TK_BRACKET_CLOSE) {
  1224. break;
  1225. }
  1226. if (parsing_tag && token.type == TK_PERIOD) {
  1227. r_tag.name += "."; //support tags such as [someprop.Android] for specific platforms
  1228. get_token(p_stream, token, line, r_err_str);
  1229. } else if (parsing_tag && token.type == TK_COLON) {
  1230. r_tag.name += ":"; //support tags such as [someprop.Android] for specific platforms
  1231. get_token(p_stream, token, line, r_err_str);
  1232. } else {
  1233. parsing_tag = false;
  1234. }
  1235. if (token.type != TK_IDENTIFIER) {
  1236. r_err_str = "Expected Identifier";
  1237. return ERR_PARSE_ERROR;
  1238. }
  1239. String id = token.value;
  1240. if (parsing_tag) {
  1241. r_tag.name += id;
  1242. continue;
  1243. }
  1244. get_token(p_stream, token, line, r_err_str);
  1245. if (token.type != TK_EQUAL) {
  1246. return ERR_PARSE_ERROR;
  1247. }
  1248. get_token(p_stream, token, line, r_err_str);
  1249. Variant value;
  1250. Error err = parse_value(token, value, p_stream, line, r_err_str, p_res_parser);
  1251. if (err) {
  1252. return err;
  1253. }
  1254. r_tag.fields[id] = value;
  1255. }
  1256. return OK;
  1257. }
  1258. Error VariantParser::parse_tag(Stream *p_stream, int &line, String &r_err_str, Tag &r_tag, ResourceParser *p_res_parser, bool p_simple_tag) {
  1259. Token token;
  1260. get_token(p_stream, token, line, r_err_str);
  1261. if (token.type == TK_EOF) {
  1262. return ERR_FILE_EOF;
  1263. }
  1264. if (token.type != TK_BRACKET_OPEN) {
  1265. r_err_str = "Expected '['";
  1266. return ERR_PARSE_ERROR;
  1267. }
  1268. return _parse_tag(token, p_stream, line, r_err_str, r_tag, p_res_parser, p_simple_tag);
  1269. }
  1270. Error VariantParser::parse_tag_assign_eof(Stream *p_stream, int &line, String &r_err_str, Tag &r_tag, String &r_assign, Variant &r_value, ResourceParser *p_res_parser, bool p_simple_tag) {
  1271. //assign..
  1272. r_assign = "";
  1273. String what;
  1274. while (true) {
  1275. char32_t c;
  1276. if (p_stream->saved) {
  1277. c = p_stream->saved;
  1278. p_stream->saved = 0;
  1279. } else {
  1280. c = p_stream->get_char();
  1281. }
  1282. if (p_stream->is_eof()) {
  1283. return ERR_FILE_EOF;
  1284. }
  1285. if (c == ';') { //comment
  1286. while (true) {
  1287. char32_t ch = p_stream->get_char();
  1288. if (p_stream->is_eof()) {
  1289. return ERR_FILE_EOF;
  1290. }
  1291. if (ch == '\n') {
  1292. line++;
  1293. break;
  1294. }
  1295. }
  1296. continue;
  1297. }
  1298. if (c == '[' && what.length() == 0) {
  1299. //it's a tag!
  1300. p_stream->saved = '['; //go back one
  1301. Error err = parse_tag(p_stream, line, r_err_str, r_tag, p_res_parser, p_simple_tag);
  1302. return err;
  1303. }
  1304. if (c > 32) {
  1305. if (c == '"') { //quoted
  1306. p_stream->saved = '"';
  1307. Token tk;
  1308. Error err = get_token(p_stream, tk, line, r_err_str);
  1309. if (err) {
  1310. return err;
  1311. }
  1312. if (tk.type != TK_STRING) {
  1313. r_err_str = "Error reading quoted string";
  1314. return ERR_INVALID_DATA;
  1315. }
  1316. what = tk.value;
  1317. } else if (c != '=') {
  1318. what += String::chr(c);
  1319. } else {
  1320. r_assign = what;
  1321. Token token;
  1322. get_token(p_stream, token, line, r_err_str);
  1323. Error err = parse_value(token, r_value, p_stream, line, r_err_str, p_res_parser);
  1324. return err;
  1325. }
  1326. } else if (c == '\n') {
  1327. line++;
  1328. }
  1329. }
  1330. }
  1331. Error VariantParser::parse(Stream *p_stream, Variant &r_ret, String &r_err_str, int &r_err_line, ResourceParser *p_res_parser) {
  1332. Token token;
  1333. Error err = get_token(p_stream, token, r_err_line, r_err_str);
  1334. if (err) {
  1335. return err;
  1336. }
  1337. if (token.type == TK_EOF) {
  1338. return ERR_FILE_EOF;
  1339. }
  1340. return parse_value(token, r_ret, p_stream, r_err_line, r_err_str, p_res_parser);
  1341. }
  1342. //////////////////////////////////////////////////////////////////////////////////
  1343. //////////////////////////////////////////////////////////////////////////////////
  1344. //////////////////////////////////////////////////////////////////////////////////
  1345. static String rtos_fix(double p_value) {
  1346. if (p_value == 0.0) {
  1347. return "0"; //avoid negative zero (-0) being written, which may annoy git, svn, etc. for changes when they don't exist.
  1348. } else if (isnan(p_value)) {
  1349. return "nan";
  1350. } else if (isinf(p_value)) {
  1351. if (p_value > 0) {
  1352. return "inf";
  1353. } else {
  1354. return "inf_neg";
  1355. }
  1356. } else {
  1357. return rtoss(p_value);
  1358. }
  1359. }
  1360. Error VariantWriter::write(const Variant &p_variant, StoreStringFunc p_store_string_func, void *p_store_string_ud, EncodeResourceFunc p_encode_res_func, void *p_encode_res_ud, int recursion_count) {
  1361. switch (p_variant.get_type()) {
  1362. case Variant::NIL: {
  1363. p_store_string_func(p_store_string_ud, "null");
  1364. } break;
  1365. case Variant::BOOL: {
  1366. p_store_string_func(p_store_string_ud, p_variant.operator bool() ? "true" : "false");
  1367. } break;
  1368. case Variant::INT: {
  1369. p_store_string_func(p_store_string_ud, itos(p_variant.operator int64_t()));
  1370. } break;
  1371. case Variant::FLOAT: {
  1372. String s = rtos_fix(p_variant.operator double());
  1373. if (s != "inf" && s != "inf_neg" && s != "nan") {
  1374. if (!s.contains(".") && !s.contains("e")) {
  1375. s += ".0";
  1376. }
  1377. }
  1378. p_store_string_func(p_store_string_ud, s);
  1379. } break;
  1380. case Variant::STRING: {
  1381. String str = p_variant;
  1382. str = "\"" + str.c_escape_multiline() + "\"";
  1383. p_store_string_func(p_store_string_ud, str);
  1384. } break;
  1385. case Variant::VECTOR2: {
  1386. Vector2 v = p_variant;
  1387. p_store_string_func(p_store_string_ud, "Vector2(" + rtos_fix(v.x) + ", " + rtos_fix(v.y) + ")");
  1388. } break;
  1389. case Variant::VECTOR2I: {
  1390. Vector2i v = p_variant;
  1391. p_store_string_func(p_store_string_ud, "Vector2i(" + itos(v.x) + ", " + itos(v.y) + ")");
  1392. } break;
  1393. case Variant::RECT2: {
  1394. Rect2 aabb = p_variant;
  1395. p_store_string_func(p_store_string_ud, "Rect2(" + rtos_fix(aabb.position.x) + ", " + rtos_fix(aabb.position.y) + ", " + rtos_fix(aabb.size.x) + ", " + rtos_fix(aabb.size.y) + ")");
  1396. } break;
  1397. case Variant::RECT2I: {
  1398. Rect2i aabb = p_variant;
  1399. p_store_string_func(p_store_string_ud, "Rect2i(" + itos(aabb.position.x) + ", " + itos(aabb.position.y) + ", " + itos(aabb.size.x) + ", " + itos(aabb.size.y) + ")");
  1400. } break;
  1401. case Variant::VECTOR3: {
  1402. Vector3 v = p_variant;
  1403. p_store_string_func(p_store_string_ud, "Vector3(" + rtos_fix(v.x) + ", " + rtos_fix(v.y) + ", " + rtos_fix(v.z) + ")");
  1404. } break;
  1405. case Variant::VECTOR3I: {
  1406. Vector3i v = p_variant;
  1407. p_store_string_func(p_store_string_ud, "Vector3i(" + itos(v.x) + ", " + itos(v.y) + ", " + itos(v.z) + ")");
  1408. } break;
  1409. case Variant::VECTOR4: {
  1410. Vector4 v = p_variant;
  1411. p_store_string_func(p_store_string_ud, "Vector4(" + rtos_fix(v.x) + ", " + rtos_fix(v.y) + ", " + rtos_fix(v.z) + ", " + rtos_fix(v.w) + ")");
  1412. } break;
  1413. case Variant::VECTOR4I: {
  1414. Vector4i v = p_variant;
  1415. p_store_string_func(p_store_string_ud, "Vector4i(" + itos(v.x) + ", " + itos(v.y) + ", " + itos(v.z) + ", " + itos(v.w) + ")");
  1416. } break;
  1417. case Variant::PLANE: {
  1418. Plane p = p_variant;
  1419. p_store_string_func(p_store_string_ud, "Plane(" + rtos_fix(p.normal.x) + ", " + rtos_fix(p.normal.y) + ", " + rtos_fix(p.normal.z) + ", " + rtos_fix(p.d) + ")");
  1420. } break;
  1421. case Variant::AABB: {
  1422. AABB aabb = p_variant;
  1423. p_store_string_func(p_store_string_ud, "AABB(" + rtos_fix(aabb.position.x) + ", " + rtos_fix(aabb.position.y) + ", " + rtos_fix(aabb.position.z) + ", " + rtos_fix(aabb.size.x) + ", " + rtos_fix(aabb.size.y) + ", " + rtos_fix(aabb.size.z) + ")");
  1424. } break;
  1425. case Variant::QUATERNION: {
  1426. Quaternion quaternion = p_variant;
  1427. p_store_string_func(p_store_string_ud, "Quaternion(" + rtos_fix(quaternion.x) + ", " + rtos_fix(quaternion.y) + ", " + rtos_fix(quaternion.z) + ", " + rtos_fix(quaternion.w) + ")");
  1428. } break;
  1429. case Variant::TRANSFORM2D: {
  1430. String s = "Transform2D(";
  1431. Transform2D m3 = p_variant;
  1432. for (int i = 0; i < 3; i++) {
  1433. for (int j = 0; j < 2; j++) {
  1434. if (i != 0 || j != 0) {
  1435. s += ", ";
  1436. }
  1437. s += rtos_fix(m3.columns[i][j]);
  1438. }
  1439. }
  1440. p_store_string_func(p_store_string_ud, s + ")");
  1441. } break;
  1442. case Variant::BASIS: {
  1443. String s = "Basis(";
  1444. Basis m3 = p_variant;
  1445. for (int i = 0; i < 3; i++) {
  1446. for (int j = 0; j < 3; j++) {
  1447. if (i != 0 || j != 0) {
  1448. s += ", ";
  1449. }
  1450. s += rtos_fix(m3.rows[i][j]);
  1451. }
  1452. }
  1453. p_store_string_func(p_store_string_ud, s + ")");
  1454. } break;
  1455. case Variant::TRANSFORM3D: {
  1456. String s = "Transform3D(";
  1457. Transform3D t = p_variant;
  1458. Basis &m3 = t.basis;
  1459. for (int i = 0; i < 3; i++) {
  1460. for (int j = 0; j < 3; j++) {
  1461. if (i != 0 || j != 0) {
  1462. s += ", ";
  1463. }
  1464. s += rtos_fix(m3.rows[i][j]);
  1465. }
  1466. }
  1467. s = s + ", " + rtos_fix(t.origin.x) + ", " + rtos_fix(t.origin.y) + ", " + rtos_fix(t.origin.z);
  1468. p_store_string_func(p_store_string_ud, s + ")");
  1469. } break;
  1470. case Variant::PROJECTION: {
  1471. String s = "Projection(";
  1472. Projection t = p_variant;
  1473. for (int i = 0; i < 4; i++) {
  1474. for (int j = 0; j < 4; j++) {
  1475. if (i != 0 || j != 0) {
  1476. s += ", ";
  1477. }
  1478. s += rtos_fix(t.columns[i][j]);
  1479. }
  1480. }
  1481. p_store_string_func(p_store_string_ud, s + ")");
  1482. } break;
  1483. // misc types
  1484. case Variant::COLOR: {
  1485. Color c = p_variant;
  1486. p_store_string_func(p_store_string_ud, "Color(" + rtos_fix(c.r) + ", " + rtos_fix(c.g) + ", " + rtos_fix(c.b) + ", " + rtos_fix(c.a) + ")");
  1487. } break;
  1488. case Variant::STRING_NAME: {
  1489. String str = p_variant;
  1490. str = "&\"" + str.c_escape() + "\"";
  1491. p_store_string_func(p_store_string_ud, str);
  1492. } break;
  1493. case Variant::NODE_PATH: {
  1494. String str = p_variant;
  1495. str = "NodePath(\"" + str.c_escape() + "\")";
  1496. p_store_string_func(p_store_string_ud, str);
  1497. } break;
  1498. case Variant::OBJECT: {
  1499. Object *obj = p_variant.get_validated_object();
  1500. if (!obj) {
  1501. p_store_string_func(p_store_string_ud, "null");
  1502. break; // don't save it
  1503. }
  1504. Ref<Resource> res = p_variant;
  1505. if (res.is_valid()) {
  1506. //is resource
  1507. String res_text;
  1508. //try external function
  1509. if (p_encode_res_func) {
  1510. res_text = p_encode_res_func(p_encode_res_ud, res);
  1511. }
  1512. //try path because it's a file
  1513. if (res_text.is_empty() && res->get_path().is_resource_file()) {
  1514. //external resource
  1515. String path = res->get_path();
  1516. res_text = "Resource(\"" + path + "\")";
  1517. }
  1518. //could come up with some sort of text
  1519. if (!res_text.is_empty()) {
  1520. p_store_string_func(p_store_string_ud, res_text);
  1521. break;
  1522. }
  1523. }
  1524. //store as generic object
  1525. p_store_string_func(p_store_string_ud, "Object(" + obj->get_class() + ",");
  1526. List<PropertyInfo> props;
  1527. obj->get_property_list(&props);
  1528. bool first = true;
  1529. for (const PropertyInfo &E : props) {
  1530. if (E.usage & PROPERTY_USAGE_STORAGE || E.usage & PROPERTY_USAGE_SCRIPT_VARIABLE) {
  1531. //must be serialized
  1532. if (first) {
  1533. first = false;
  1534. } else {
  1535. p_store_string_func(p_store_string_ud, ",");
  1536. }
  1537. p_store_string_func(p_store_string_ud, "\"" + E.name + "\":");
  1538. write(obj->get(E.name), p_store_string_func, p_store_string_ud, p_encode_res_func, p_encode_res_ud);
  1539. }
  1540. }
  1541. p_store_string_func(p_store_string_ud, ")\n");
  1542. } break;
  1543. case Variant::DICTIONARY: {
  1544. Dictionary dict = p_variant;
  1545. if (recursion_count > MAX_RECURSION) {
  1546. ERR_PRINT("Max recursion reached");
  1547. p_store_string_func(p_store_string_ud, "{}");
  1548. } else {
  1549. recursion_count++;
  1550. List<Variant> keys;
  1551. dict.get_key_list(&keys);
  1552. keys.sort();
  1553. if (keys.is_empty()) { // Avoid unnecessary line break.
  1554. p_store_string_func(p_store_string_ud, "{}");
  1555. break;
  1556. }
  1557. p_store_string_func(p_store_string_ud, "{\n");
  1558. for (List<Variant>::Element *E = keys.front(); E; E = E->next()) {
  1559. write(E->get(), p_store_string_func, p_store_string_ud, p_encode_res_func, p_encode_res_ud, recursion_count);
  1560. p_store_string_func(p_store_string_ud, ": ");
  1561. write(dict[E->get()], p_store_string_func, p_store_string_ud, p_encode_res_func, p_encode_res_ud, recursion_count);
  1562. if (E->next()) {
  1563. p_store_string_func(p_store_string_ud, ",\n");
  1564. } else {
  1565. p_store_string_func(p_store_string_ud, "\n");
  1566. }
  1567. }
  1568. p_store_string_func(p_store_string_ud, "}");
  1569. }
  1570. } break;
  1571. case Variant::ARRAY: {
  1572. if (recursion_count > MAX_RECURSION) {
  1573. ERR_PRINT("Max recursion reached");
  1574. p_store_string_func(p_store_string_ud, "[]");
  1575. } else {
  1576. recursion_count++;
  1577. p_store_string_func(p_store_string_ud, "[");
  1578. Array array = p_variant;
  1579. int len = array.size();
  1580. for (int i = 0; i < len; i++) {
  1581. if (i > 0) {
  1582. p_store_string_func(p_store_string_ud, ", ");
  1583. }
  1584. write(array[i], p_store_string_func, p_store_string_ud, p_encode_res_func, p_encode_res_ud, recursion_count);
  1585. }
  1586. p_store_string_func(p_store_string_ud, "]");
  1587. }
  1588. } break;
  1589. case Variant::PACKED_BYTE_ARRAY: {
  1590. p_store_string_func(p_store_string_ud, "PackedByteArray(");
  1591. String s;
  1592. Vector<uint8_t> data = p_variant;
  1593. int len = data.size();
  1594. const uint8_t *ptr = data.ptr();
  1595. for (int i = 0; i < len; i++) {
  1596. if (i > 0) {
  1597. p_store_string_func(p_store_string_ud, ", ");
  1598. }
  1599. p_store_string_func(p_store_string_ud, itos(ptr[i]));
  1600. }
  1601. p_store_string_func(p_store_string_ud, ")");
  1602. } break;
  1603. case Variant::PACKED_INT32_ARRAY: {
  1604. p_store_string_func(p_store_string_ud, "PackedInt32Array(");
  1605. Vector<int32_t> data = p_variant;
  1606. int32_t len = data.size();
  1607. const int32_t *ptr = data.ptr();
  1608. for (int32_t i = 0; i < len; i++) {
  1609. if (i > 0) {
  1610. p_store_string_func(p_store_string_ud, ", ");
  1611. }
  1612. p_store_string_func(p_store_string_ud, itos(ptr[i]));
  1613. }
  1614. p_store_string_func(p_store_string_ud, ")");
  1615. } break;
  1616. case Variant::PACKED_INT64_ARRAY: {
  1617. p_store_string_func(p_store_string_ud, "PackedInt64Array(");
  1618. Vector<int64_t> data = p_variant;
  1619. int64_t len = data.size();
  1620. const int64_t *ptr = data.ptr();
  1621. for (int64_t i = 0; i < len; i++) {
  1622. if (i > 0) {
  1623. p_store_string_func(p_store_string_ud, ", ");
  1624. }
  1625. p_store_string_func(p_store_string_ud, itos(ptr[i]));
  1626. }
  1627. p_store_string_func(p_store_string_ud, ")");
  1628. } break;
  1629. case Variant::PACKED_FLOAT32_ARRAY: {
  1630. p_store_string_func(p_store_string_ud, "PackedFloat32Array(");
  1631. Vector<float> data = p_variant;
  1632. int len = data.size();
  1633. const float *ptr = data.ptr();
  1634. for (int i = 0; i < len; i++) {
  1635. if (i > 0) {
  1636. p_store_string_func(p_store_string_ud, ", ");
  1637. }
  1638. p_store_string_func(p_store_string_ud, rtos_fix(ptr[i]));
  1639. }
  1640. p_store_string_func(p_store_string_ud, ")");
  1641. } break;
  1642. case Variant::PACKED_FLOAT64_ARRAY: {
  1643. p_store_string_func(p_store_string_ud, "PackedFloat64Array(");
  1644. Vector<double> data = p_variant;
  1645. int len = data.size();
  1646. const double *ptr = data.ptr();
  1647. for (int i = 0; i < len; i++) {
  1648. if (i > 0) {
  1649. p_store_string_func(p_store_string_ud, ", ");
  1650. }
  1651. p_store_string_func(p_store_string_ud, rtos_fix(ptr[i]));
  1652. }
  1653. p_store_string_func(p_store_string_ud, ")");
  1654. } break;
  1655. case Variant::PACKED_STRING_ARRAY: {
  1656. p_store_string_func(p_store_string_ud, "PackedStringArray(");
  1657. Vector<String> data = p_variant;
  1658. int len = data.size();
  1659. const String *ptr = data.ptr();
  1660. String s;
  1661. //write_string("\n");
  1662. for (int i = 0; i < len; i++) {
  1663. if (i > 0) {
  1664. p_store_string_func(p_store_string_ud, ", ");
  1665. }
  1666. String str = ptr[i];
  1667. p_store_string_func(p_store_string_ud, "\"" + str.c_escape() + "\"");
  1668. }
  1669. p_store_string_func(p_store_string_ud, ")");
  1670. } break;
  1671. case Variant::PACKED_VECTOR2_ARRAY: {
  1672. p_store_string_func(p_store_string_ud, "PackedVector2Array(");
  1673. Vector<Vector2> data = p_variant;
  1674. int len = data.size();
  1675. const Vector2 *ptr = data.ptr();
  1676. for (int i = 0; i < len; i++) {
  1677. if (i > 0) {
  1678. p_store_string_func(p_store_string_ud, ", ");
  1679. }
  1680. p_store_string_func(p_store_string_ud, rtos_fix(ptr[i].x) + ", " + rtos_fix(ptr[i].y));
  1681. }
  1682. p_store_string_func(p_store_string_ud, ")");
  1683. } break;
  1684. case Variant::PACKED_VECTOR3_ARRAY: {
  1685. p_store_string_func(p_store_string_ud, "PackedVector3Array(");
  1686. Vector<Vector3> data = p_variant;
  1687. int len = data.size();
  1688. const Vector3 *ptr = data.ptr();
  1689. for (int i = 0; i < len; i++) {
  1690. if (i > 0) {
  1691. p_store_string_func(p_store_string_ud, ", ");
  1692. }
  1693. p_store_string_func(p_store_string_ud, rtos_fix(ptr[i].x) + ", " + rtos_fix(ptr[i].y) + ", " + rtos_fix(ptr[i].z));
  1694. }
  1695. p_store_string_func(p_store_string_ud, ")");
  1696. } break;
  1697. case Variant::PACKED_COLOR_ARRAY: {
  1698. p_store_string_func(p_store_string_ud, "PackedColorArray(");
  1699. Vector<Color> data = p_variant;
  1700. int len = data.size();
  1701. const Color *ptr = data.ptr();
  1702. for (int i = 0; i < len; i++) {
  1703. if (i > 0) {
  1704. p_store_string_func(p_store_string_ud, ", ");
  1705. }
  1706. p_store_string_func(p_store_string_ud, rtos_fix(ptr[i].r) + ", " + rtos_fix(ptr[i].g) + ", " + rtos_fix(ptr[i].b) + ", " + rtos_fix(ptr[i].a));
  1707. }
  1708. p_store_string_func(p_store_string_ud, ")");
  1709. } break;
  1710. default: {
  1711. }
  1712. }
  1713. return OK;
  1714. }
  1715. static Error _write_to_str(void *ud, const String &p_string) {
  1716. String *str = (String *)ud;
  1717. (*str) += p_string;
  1718. return OK;
  1719. }
  1720. Error VariantWriter::write_to_string(const Variant &p_variant, String &r_string, EncodeResourceFunc p_encode_res_func, void *p_encode_res_ud) {
  1721. r_string = String();
  1722. return write(p_variant, _write_to_str, &r_string, p_encode_res_func, p_encode_res_ud);
  1723. }