DataParser.cpp 31 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189
  1. /*
  2. * This source file is part of RmlUi, the HTML/CSS Interface Middleware
  3. *
  4. * For the latest information, see http://github.com/mikke89/RmlUi
  5. *
  6. * Copyright (c) 2008-2010 CodePoint Ltd, Shift Technology Ltd
  7. * Copyright (c) 2019 The RmlUi Team, and contributors
  8. *
  9. * Permission is hereby granted, free of charge, to any person obtaining a copy
  10. * of this software and associated documentation files (the "Software"), to deal
  11. * in the Software without restriction, including without limitation the rights
  12. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  13. * copies of the Software, and to permit persons to whom the Software is
  14. * furnished to do so, subject to the following conditions:
  15. *
  16. * The above copyright notice and this permission notice shall be included in
  17. * all copies or substantial portions of the Software.
  18. *
  19. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  22. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  23. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  24. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  25. * THE SOFTWARE.
  26. *
  27. */
  28. #include "../../Include/RmlUi/Core/DataModel.h"
  29. #include "DataParser.h"
  30. #include <stack>
  31. #ifdef _MSC_VER
  32. #pragma warning(default : 4061)
  33. #pragma warning(default : 4062)
  34. #endif
  35. namespace Rml {
  36. namespace Core {
  37. class DataParser;
  38. /*
  39. The abstract machine for RmlUi data scripts.
  40. The machine can execute a program which contains a list of instructions listed below.
  41. The abstract machine has three registers:
  42. R Typically results and right-hand side arguments.
  43. L Typically left-hand side arguments.
  44. C Typically center arguments (eg. in ternary operator).
  45. And two stacks:
  46. S The main program stack.
  47. A The arguments stack, only used to pass arguments to an external transform function.
  48. In addition, each instruction has an optional payload:
  49. D Instruction data (payload).
  50. Notation used in the instruction list below:
  51. S+ Push to stack S.
  52. S- Pop stack S (returns the popped value).
  53. */
  54. enum class Instruction { // Assignment (register/stack) = Read (register R/L/C, instruction data D, or stack)
  55. Push = 'P', // S+ = R
  56. Pop = 'o', // <R/L/C> = S- (D determines R/L/C)
  57. Literal = 'D', // R = D
  58. Variable = 'V', // R = DataModel.GetVariable(D) (D is an index into the variable address list)
  59. Add = '+', // R = L + R
  60. Subtract = '-', // R = L - R
  61. Multiply = '*', // R = L * R
  62. Divide = '/', // R = L / R
  63. Not = '!', // R = !R
  64. And = '&', // R = L && R
  65. Or = '|', // R = L || R
  66. Less = '<', // R = L < R
  67. LessEq = 'L', // R = L <= R
  68. Greater = '>', // R = L > R
  69. GreaterEq = 'G', // R = L >= R
  70. Equal = '=', // R = L == R
  71. NotEqual = 'N', // R = L != R
  72. Ternary = '?', // R = L ? C : R
  73. Arguments = 'a', // A+ = S- (Repeated D times, where D gives the num. arguments)
  74. TransformFnc = 'T', // R = DataModel.Execute( D, R, A ); A.Clear(); (D determines function name, R the input value, A the arguments)
  75. EventFnc = 'E', // DataModel.EventCallback(D, A); A.Clear();
  76. Assign = 'A', // DataModel.SetVariable(D, R)
  77. };
  78. enum class Register {
  79. R,
  80. L,
  81. C
  82. };
  83. struct InstructionData {
  84. Instruction instruction;
  85. Variant data;
  86. };
  87. namespace Parse {
  88. static void Assignment(DataParser& parser);
  89. static void Expression(DataParser& parser);
  90. };
  91. class DataParser {
  92. public:
  93. DataParser(String expression, DataExpressionInterface expression_interface) : expression(std::move(expression)), expression_interface(expression_interface) {}
  94. char Look() {
  95. if (reached_end)
  96. return '\0';
  97. return expression[index];
  98. }
  99. bool Match(char c, bool skip_whitespace = true) {
  100. if (c == Look()) {
  101. Next();
  102. if (skip_whitespace)
  103. SkipWhitespace();
  104. return true;
  105. }
  106. Expected(c);
  107. return false;
  108. }
  109. char Next() {
  110. ++index;
  111. if (index >= expression.size())
  112. reached_end = true;
  113. return Look();
  114. }
  115. void SkipWhitespace() {
  116. char c = Look();
  117. while (StringUtilities::IsWhitespace(c))
  118. c = Next();
  119. }
  120. void Error(const String message)
  121. {
  122. parse_error = true;
  123. Log::Message(Log::LT_WARNING, "Error in data expression at %d. %s", index, message.c_str());
  124. Log::Message(Log::LT_WARNING, " \"%s\"", expression.c_str());
  125. const size_t cursor_offset = size_t(index) + 3;
  126. const String cursor_string = String(cursor_offset, ' ') + '^';
  127. Log::Message(Log::LT_WARNING, cursor_string.c_str());
  128. }
  129. void Expected(String expected_symbols) {
  130. const char c = Look();
  131. if (c == '\0')
  132. Error(CreateString(expected_symbols.size() + 50, "Expected %s but found end of string.", expected_symbols.c_str()));
  133. else
  134. Error(CreateString(expected_symbols.size() + 50, "Expected %s but found character '%c'.", expected_symbols.c_str(), c));
  135. }
  136. void Expected(char expected) {
  137. Expected(String(1, '\'') + expected + '\'');
  138. }
  139. bool Parse(bool is_assignment_expression)
  140. {
  141. program.clear();
  142. variable_addresses.clear();
  143. index = 0;
  144. reached_end = false;
  145. parse_error = false;
  146. if (expression.empty())
  147. reached_end = true;
  148. SkipWhitespace();
  149. if (is_assignment_expression)
  150. Parse::Assignment(*this);
  151. else
  152. Parse::Expression(*this);
  153. if (!reached_end) {
  154. parse_error = true;
  155. Error(CreateString(50, "Unexpected character '%c' encountered.", Look()));
  156. }
  157. if (!parse_error && program_stack_size != 0) {
  158. parse_error = true;
  159. Error(CreateString(120, "Internal parser error, inconsistent stack operations. Stack size is %d at parse end.", program_stack_size));
  160. }
  161. return !parse_error;
  162. }
  163. Program ReleaseProgram() {
  164. RMLUI_ASSERT(!parse_error);
  165. return std::move(program);
  166. }
  167. AddressList ReleaseAddresses() {
  168. RMLUI_ASSERT(!parse_error);
  169. return std::move(variable_addresses);
  170. }
  171. void Emit(Instruction instruction, Variant data = Variant())
  172. {
  173. RMLUI_ASSERTMSG(instruction != Instruction::Push && instruction != Instruction::Pop &&
  174. instruction != Instruction::Arguments && instruction != Instruction::Variable && instruction != Instruction::Assign,
  175. "Use the Push(), Pop(), Arguments(), Variable(), and Assign() procedures for stack manipulation and variable instructions.");
  176. program.push_back(InstructionData{ instruction, std::move(data) });
  177. }
  178. void Push() {
  179. program_stack_size += 1;
  180. program.push_back(InstructionData{ Instruction::Push, Variant() });
  181. }
  182. void Pop(Register destination) {
  183. if (program_stack_size <= 0) {
  184. Error("Internal parser error: Tried to pop an empty stack.");
  185. return;
  186. }
  187. program_stack_size -= 1;
  188. program.push_back(InstructionData{ Instruction::Pop, Variant(int(destination)) });
  189. }
  190. void Arguments(int num_arguments) {
  191. if (program_stack_size < num_arguments) {
  192. Error(CreateString(128, "Internal parser error: Popping %d arguments, but the stack contains only %d elements.", num_arguments, program_stack_size));
  193. return;
  194. }
  195. program_stack_size -= num_arguments;
  196. program.push_back(InstructionData{ Instruction::Arguments, Variant(int(num_arguments)) });
  197. }
  198. void Variable(const String& name) {
  199. VariableGetSet(name, false);
  200. }
  201. void Assign(const String& name) {
  202. VariableGetSet(name, true);
  203. }
  204. private:
  205. void VariableGetSet(const String& name, bool is_assignment)
  206. {
  207. DataAddress address = expression_interface.ParseAddress(name);
  208. if (address.empty()) {
  209. Error(CreateString(name.size() + 50, "Could not find data variable with name '%s'.", name.c_str()));
  210. return;
  211. }
  212. int index = int(variable_addresses.size());
  213. variable_addresses.push_back(std::move(address));
  214. program.push_back(InstructionData{ is_assignment ? Instruction::Assign : Instruction::Variable, Variant(int(index)) });
  215. }
  216. const String expression;
  217. DataExpressionInterface expression_interface;
  218. size_t index = 0;
  219. bool reached_end = false;
  220. bool parse_error = true;
  221. int program_stack_size = 0;
  222. Program program;
  223. AddressList variable_addresses;
  224. };
  225. namespace Parse {
  226. // Forward declare all parse functions.
  227. static void Assignment(DataParser& parser);
  228. // The following in order of precedence.
  229. static void Expression(DataParser& parser);
  230. static void Relational(DataParser& parser);
  231. static void Additive(DataParser& parser);
  232. static void Term(DataParser& parser);
  233. static void Factor(DataParser& parser);
  234. static void NumberLiteral(DataParser& parser);
  235. static void StringLiteral(DataParser& parser);
  236. static void Variable(DataParser& parser);
  237. static void Add(DataParser& parser);
  238. static void Subtract(DataParser& parser);
  239. static void Multiply(DataParser& parser);
  240. static void Divide(DataParser& parser);
  241. static void Not(DataParser& parser);
  242. static void And(DataParser& parser);
  243. static void Or(DataParser& parser);
  244. static void Less(DataParser& parser);
  245. static void Greater(DataParser& parser);
  246. static void Equal(DataParser& parser);
  247. static void NotEqual(DataParser& parser);
  248. static void Ternary(DataParser& parser);
  249. static void Function(DataParser& parser, Instruction function_type, const String& name);
  250. // Helper functions
  251. static bool IsVariableCharacter(char c, bool is_first_character)
  252. {
  253. const bool is_alpha = (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z');
  254. if (is_first_character)
  255. return is_alpha;
  256. if (is_alpha || (c >= '0' && c <= '9'))
  257. return true;
  258. for (char valid_char : "_.[] ")
  259. {
  260. if (c == valid_char && valid_char != '\0')
  261. return true;
  262. }
  263. return false;
  264. }
  265. static String VariableName(DataParser& parser)
  266. {
  267. String name;
  268. bool is_first_character = true;
  269. char c = parser.Look();
  270. while (IsVariableCharacter(c, is_first_character))
  271. {
  272. name += c;
  273. c = parser.Next();
  274. is_first_character = false;
  275. }
  276. // Right trim spaces in name
  277. size_t new_size = String::npos;
  278. for (int i = int(name.size()) - 1; i >= 1; i--)
  279. {
  280. if (name[i] == ' ')
  281. new_size = size_t(i);
  282. else
  283. break;
  284. }
  285. if (new_size != String::npos)
  286. name.resize(new_size);
  287. return name;
  288. }
  289. // Parser functions
  290. static void Assignment(DataParser& parser)
  291. {
  292. bool looping = true;
  293. while (looping)
  294. {
  295. if (parser.Look() != '\0')
  296. {
  297. const String variable_name = VariableName(parser);
  298. if (variable_name.empty()) {
  299. parser.Error("Expected a variable for assignment but got an empty name.");
  300. return;
  301. }
  302. const char c = parser.Look();
  303. if (c == '=')
  304. {
  305. parser.Match('=');
  306. Expression(parser);
  307. parser.Assign(variable_name);
  308. }
  309. else if (c == '(' || c == ';' || c == '\0')
  310. {
  311. Function(parser, Instruction::EventFnc, variable_name);
  312. }
  313. else
  314. {
  315. parser.Expected("one of = ; ( or end of string");
  316. return;
  317. }
  318. }
  319. const char c = parser.Look();
  320. if (c == ';')
  321. parser.Match(';');
  322. else if (c == '\0')
  323. looping = false;
  324. else
  325. {
  326. parser.Expected("';' or end of string");
  327. looping = false;
  328. }
  329. }
  330. }
  331. static void Expression(DataParser& parser)
  332. {
  333. Relational(parser);
  334. bool looping = true;
  335. while (looping)
  336. {
  337. switch (char c = parser.Look())
  338. {
  339. case '&': And(parser); break;
  340. case '|':
  341. {
  342. parser.Match('|', false);
  343. if (parser.Look() == '|')
  344. Or(parser);
  345. else
  346. {
  347. parser.SkipWhitespace();
  348. const String fnc_name = VariableName(parser);
  349. if (fnc_name.empty()) {
  350. parser.Error("Expected a transform function name but got an empty name.");
  351. return;
  352. }
  353. Function(parser, Instruction::TransformFnc, fnc_name);
  354. }
  355. }
  356. break;
  357. case '?': Ternary(parser); break;
  358. default:
  359. looping = false;
  360. }
  361. }
  362. }
  363. static void Relational(DataParser& parser)
  364. {
  365. Additive(parser);
  366. bool looping = true;
  367. while (looping)
  368. {
  369. switch (const char c = parser.Look())
  370. {
  371. case '=': Equal(parser); break;
  372. case '!': NotEqual(parser); break;
  373. case '<': Less(parser); break;
  374. case '>': Greater(parser); break;
  375. default:
  376. looping = false;
  377. }
  378. }
  379. }
  380. static void Additive(DataParser& parser)
  381. {
  382. Term(parser);
  383. bool looping = true;
  384. while (looping)
  385. {
  386. switch (const char c = parser.Look())
  387. {
  388. case '+': Add(parser); break;
  389. case '-': Subtract(parser); break;
  390. default:
  391. looping = false;
  392. }
  393. }
  394. }
  395. static void Term(DataParser& parser)
  396. {
  397. Factor(parser);
  398. bool looping = true;
  399. while (looping)
  400. {
  401. switch (const char c = parser.Look())
  402. {
  403. case '*': Multiply(parser); break;
  404. case '/': Divide(parser); break;
  405. default:
  406. looping = false;
  407. }
  408. }
  409. }
  410. static void Factor(DataParser& parser)
  411. {
  412. const char c = parser.Look();
  413. if (c == '(')
  414. {
  415. parser.Match('(');
  416. Expression(parser);
  417. parser.Match(')');
  418. }
  419. else if (c == '\'')
  420. {
  421. parser.Match('\'', false);
  422. StringLiteral(parser);
  423. parser.Match('\'');
  424. }
  425. else if (c == '!')
  426. {
  427. Not(parser);
  428. parser.SkipWhitespace();
  429. }
  430. else if (c == '-' || (c >= '0' && c <= '9'))
  431. {
  432. NumberLiteral(parser);
  433. parser.SkipWhitespace();
  434. }
  435. else if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z'))
  436. {
  437. Variable(parser);
  438. parser.SkipWhitespace();
  439. }
  440. else
  441. parser.Expected("literal, variable name, parenthesis, or '!'");
  442. }
  443. static void NumberLiteral(DataParser& parser)
  444. {
  445. String str;
  446. bool first_match = false;
  447. bool has_dot = false;
  448. char c = parser.Look();
  449. if (c == '-')
  450. {
  451. str += c;
  452. c = parser.Next();
  453. }
  454. while ((c >= '0' && c <= '9') || (c == '.' && !has_dot))
  455. {
  456. first_match = true;
  457. str += c;
  458. if (c == '.')
  459. has_dot = true;
  460. c = parser.Next();
  461. }
  462. if (!first_match)
  463. {
  464. parser.Error(CreateString(100, "Invalid number literal. Expected '0-9' or '.' but found '%c'.", c));
  465. return;
  466. }
  467. const double number = FromString(str, 0.0);
  468. parser.Emit(Instruction::Literal, Variant(number));
  469. }
  470. static void StringLiteral(DataParser& parser)
  471. {
  472. String str;
  473. char c = parser.Look();
  474. char c_prev = '\0';
  475. while (c != '\0' && (c != '\'' || c_prev == '\\'))
  476. {
  477. if (c_prev == '\\' && (c == '\\' || c == '\'')) {
  478. str.pop_back();
  479. c_prev = '\0';
  480. }
  481. else {
  482. c_prev = c;
  483. }
  484. str += c;
  485. c = parser.Next();
  486. }
  487. parser.Emit(Instruction::Literal, Variant(str));
  488. }
  489. static void Variable(DataParser& parser)
  490. {
  491. String name = VariableName(parser);
  492. if (name.empty()) {
  493. parser.Error("Expected a variable but got an empty name.");
  494. return;
  495. }
  496. // Keywords are parsed like variables, but are really literals.
  497. // Check for them here.
  498. if (name == "true")
  499. parser.Emit(Instruction::Literal, Variant(true));
  500. else if (name == "false")
  501. parser.Emit(Instruction::Literal, Variant(false));
  502. else
  503. parser.Variable(name);
  504. }
  505. static void Add(DataParser& parser)
  506. {
  507. parser.Match('+');
  508. parser.Push();
  509. Term(parser);
  510. parser.Pop(Register::L);
  511. parser.Emit(Instruction::Add);
  512. }
  513. static void Subtract(DataParser& parser)
  514. {
  515. parser.Match('-');
  516. parser.Push();
  517. Term(parser);
  518. parser.Pop(Register::L);
  519. parser.Emit(Instruction::Subtract);
  520. }
  521. static void Multiply(DataParser& parser)
  522. {
  523. parser.Match('*');
  524. parser.Push();
  525. Factor(parser);
  526. parser.Pop(Register::L);
  527. parser.Emit(Instruction::Multiply);
  528. }
  529. static void Divide(DataParser& parser)
  530. {
  531. parser.Match('/');
  532. parser.Push();
  533. Factor(parser);
  534. parser.Pop(Register::L);
  535. parser.Emit(Instruction::Divide);
  536. }
  537. static void Not(DataParser& parser)
  538. {
  539. parser.Match('!');
  540. Factor(parser);
  541. parser.Emit(Instruction::Not);
  542. }
  543. static void Or(DataParser& parser)
  544. {
  545. // We already skipped the first '|' during expression
  546. parser.Match('|');
  547. parser.Push();
  548. Relational(parser);
  549. parser.Pop(Register::L);
  550. parser.Emit(Instruction::Or);
  551. }
  552. static void And(DataParser& parser)
  553. {
  554. parser.Match('&', false);
  555. parser.Match('&');
  556. parser.Push();
  557. Relational(parser);
  558. parser.Pop(Register::L);
  559. parser.Emit(Instruction::And);
  560. }
  561. static void Less(DataParser& parser)
  562. {
  563. Instruction instruction = Instruction::Less;
  564. parser.Match('<', false);
  565. if (parser.Look() == '=') {
  566. parser.Match('=');
  567. instruction = Instruction::LessEq;
  568. }
  569. else {
  570. parser.SkipWhitespace();
  571. }
  572. parser.Push();
  573. Additive(parser);
  574. parser.Pop(Register::L);
  575. parser.Emit(instruction);
  576. }
  577. static void Greater(DataParser& parser)
  578. {
  579. Instruction instruction = Instruction::Greater;
  580. parser.Match('>', false);
  581. if (parser.Look() == '=') {
  582. parser.Match('=');
  583. instruction = Instruction::GreaterEq;
  584. }
  585. else {
  586. parser.SkipWhitespace();
  587. }
  588. parser.Push();
  589. Additive(parser);
  590. parser.Pop(Register::L);
  591. parser.Emit(instruction);
  592. }
  593. static void Equal(DataParser& parser)
  594. {
  595. parser.Match('=', false);
  596. parser.Match('=');
  597. parser.Push();
  598. Additive(parser);
  599. parser.Pop(Register::L);
  600. parser.Emit(Instruction::Equal);
  601. }
  602. static void NotEqual(DataParser& parser)
  603. {
  604. parser.Match('!', false);
  605. parser.Match('=');
  606. parser.Push();
  607. Additive(parser);
  608. parser.Pop(Register::L);
  609. parser.Emit(Instruction::NotEqual);
  610. }
  611. static void Ternary(DataParser& parser)
  612. {
  613. parser.Match('?');
  614. parser.Push();
  615. Expression(parser);
  616. parser.Push();
  617. parser.Match(':');
  618. Expression(parser);
  619. parser.Pop(Register::C);
  620. parser.Pop(Register::L);
  621. parser.Emit(Instruction::Ternary);
  622. }
  623. static void Function(DataParser& parser, Instruction function_type, const String& func_name)
  624. {
  625. RMLUI_ASSERT(function_type == Instruction::TransformFnc || function_type == Instruction::EventFnc);
  626. // We already matched the variable name (and '|' for transform functions)
  627. if (parser.Look() == '(')
  628. {
  629. int num_arguments = 0;
  630. bool looping = true;
  631. parser.Match('(');
  632. if (parser.Look() == ')') {
  633. parser.Match(')');
  634. looping = false;
  635. }
  636. else
  637. parser.Push();
  638. while (looping)
  639. {
  640. num_arguments += 1;
  641. Expression(parser);
  642. parser.Push();
  643. switch (parser.Look()) {
  644. case ')': parser.Match(')'); looping = false; break;
  645. case ',': parser.Match(','); break;
  646. default:
  647. parser.Expected("one of ')' or ','");
  648. looping = false;
  649. }
  650. }
  651. if (num_arguments > 0) {
  652. parser.Arguments(num_arguments);
  653. parser.Pop(Register::R);
  654. }
  655. }
  656. else {
  657. parser.SkipWhitespace();
  658. }
  659. parser.Emit(function_type, Variant(func_name));
  660. }
  661. } // </namespace Parse>
  662. class DataInterpreter {
  663. public:
  664. DataInterpreter(const Program& program, const AddressList& addresses, DataExpressionInterface expression_interface) : program(program), addresses(addresses), expression_interface(expression_interface) {}
  665. bool Error(String message) const
  666. {
  667. message = "Error during execution. " + message;
  668. Log::Message(Log::LT_WARNING, message.c_str());
  669. RMLUI_ERROR;
  670. return false;
  671. }
  672. bool Run()
  673. {
  674. bool success = true;
  675. for (size_t i = 0; i < program.size(); i++)
  676. {
  677. if (!Execute(program[i].instruction, program[i].data))
  678. {
  679. success = false;
  680. break;
  681. }
  682. }
  683. if(success && !stack.empty())
  684. Log::Message(Log::LT_WARNING, "Possible data interpreter stack corruption. Stack size is %d at end of execution (should be zero).", stack.size());
  685. if(!success)
  686. {
  687. String program_str = DumpProgram();
  688. Log::Message(Log::LT_WARNING, "Failed to execute program with %d instructions:", program.size());
  689. Log::Message(Log::LT_WARNING, program_str.c_str());
  690. }
  691. return success;
  692. }
  693. String DumpProgram() const
  694. {
  695. String str;
  696. for (size_t i = 0; i < program.size(); i++)
  697. {
  698. String instruction_str = program[i].data.Get<String>();
  699. str += CreateString(50 + instruction_str.size(), " %4d '%c' %s\n", i, char(program[i].instruction), instruction_str.c_str());
  700. }
  701. return str;
  702. }
  703. Variant Result() const {
  704. return R;
  705. }
  706. private:
  707. Variant R, L, C;
  708. std::stack<Variant> stack;
  709. std::vector<Variant> arguments;
  710. const Program& program;
  711. const AddressList& addresses;
  712. DataExpressionInterface expression_interface;
  713. bool Execute(const Instruction instruction, const Variant& data)
  714. {
  715. auto AnyString = [](const Variant& v1, const Variant& v2) {
  716. return v1.GetType() == Variant::STRING || v2.GetType() == Variant::STRING;
  717. };
  718. switch (instruction)
  719. {
  720. case Instruction::Push:
  721. {
  722. stack.push(std::move(R));
  723. R.Clear();
  724. }
  725. break;
  726. case Instruction::Pop:
  727. {
  728. if (stack.empty())
  729. return Error("Cannot pop stack, it is empty.");
  730. Register reg = Register(data.Get<int>(-1));
  731. switch (reg) {
  732. case Register::R: R = stack.top(); stack.pop(); break;
  733. case Register::L: L = stack.top(); stack.pop(); break;
  734. case Register::C: C = stack.top(); stack.pop(); break;
  735. default:
  736. return Error(CreateString(50, "Invalid register %d.", int(reg)));
  737. }
  738. }
  739. break;
  740. case Instruction::Literal:
  741. {
  742. R = data;
  743. }
  744. break;
  745. case Instruction::Variable:
  746. {
  747. size_t variable_index = size_t(data.Get<int>(-1));
  748. if (variable_index < addresses.size())
  749. R = expression_interface.GetValue(addresses[variable_index]);
  750. else
  751. return Error("Variable address not found.");
  752. }
  753. break;
  754. case Instruction::Add:
  755. {
  756. if (AnyString(L, R))
  757. R = Variant(L.Get<String>() + R.Get<String>());
  758. else
  759. R = Variant(L.Get<double>() + R.Get<double>());
  760. }
  761. break;
  762. case Instruction::Subtract: R = Variant(L.Get<double>() - R.Get<double>()); break;
  763. case Instruction::Multiply: R = Variant(L.Get<double>() * R.Get<double>()); break;
  764. case Instruction::Divide: R = Variant(L.Get<double>() / R.Get<double>()); break;
  765. case Instruction::Not: R = Variant(!R.Get<bool>()); break;
  766. case Instruction::And: R = Variant(L.Get<bool>() && R.Get<bool>()); break;
  767. case Instruction::Or: R = Variant(L.Get<bool>() || R.Get<bool>()); break;
  768. case Instruction::Less: R = Variant(L.Get<double>() < R.Get<double>()); break;
  769. case Instruction::LessEq: R = Variant(L.Get<double>() <= R.Get<double>()); break;
  770. case Instruction::Greater: R = Variant(L.Get<double>() > R.Get<double>()); break;
  771. case Instruction::GreaterEq: R = Variant(L.Get<double>() >= R.Get<double>()); break;
  772. case Instruction::Equal:
  773. {
  774. if (AnyString(L, R))
  775. R = Variant(L.Get<String>() == R.Get<String>());
  776. else
  777. R = Variant(L.Get<double>() == R.Get<double>());
  778. }
  779. break;
  780. case Instruction::NotEqual:
  781. {
  782. if (AnyString(L, R))
  783. R = Variant(L.Get<String>() != R.Get<String>());
  784. else
  785. R = Variant(L.Get<double>() != R.Get<double>());
  786. }
  787. break;
  788. case Instruction::Ternary:
  789. {
  790. if (L.Get<bool>())
  791. R = C;
  792. }
  793. break;
  794. case Instruction::Arguments:
  795. {
  796. if (!arguments.empty())
  797. return Error("Argument stack is not empty.");
  798. int num_arguments = data.Get<int>(-1);
  799. if (num_arguments < 0)
  800. return Error("Invalid number of arguments.");
  801. if (stack.size() < size_t(num_arguments))
  802. return Error(CreateString(100, "Cannot pop %d arguments, stack contains only %d elements.", num_arguments, stack.size()));
  803. arguments.resize(num_arguments);
  804. for (int i = num_arguments - 1; i >= 0; i--)
  805. {
  806. arguments[i] = std::move(stack.top());
  807. stack.pop();
  808. }
  809. }
  810. break;
  811. case Instruction::TransformFnc:
  812. {
  813. const String function_name = data.Get<String>();
  814. if (!expression_interface.CallTransform(function_name, R, arguments))
  815. {
  816. String arguments_str;
  817. for (size_t i = 0; i < arguments.size(); i++)
  818. {
  819. arguments_str += arguments[i].Get<String>();
  820. if (i < arguments.size() - 1)
  821. arguments_str += ", ";
  822. }
  823. Error(CreateString(50 + function_name.size() + arguments_str.size(), "Failed to execute data function: %s(%s)", function_name.c_str(), arguments_str.c_str()));
  824. }
  825. arguments.clear();
  826. }
  827. break;
  828. case Instruction::EventFnc:
  829. {
  830. const String function_name = data.Get<String>();
  831. if (!expression_interface.EventCallback(function_name, arguments))
  832. {
  833. String arguments_str;
  834. for (size_t i = 0; i < arguments.size(); i++)
  835. {
  836. arguments_str += arguments[i].Get<String>();
  837. if (i < arguments.size() - 1)
  838. arguments_str += ", ";
  839. }
  840. Error(CreateString(50 + function_name.size() + arguments_str.size(), "Failed to execute event callback: %s(%s)", function_name.c_str(), arguments_str.c_str()));
  841. }
  842. arguments.clear();
  843. }
  844. break;
  845. case Instruction::Assign:
  846. {
  847. size_t variable_index = size_t(data.Get<int>(-1));
  848. if (variable_index < addresses.size())
  849. {
  850. if (!expression_interface.SetValue(addresses[variable_index], R))
  851. return Error("Could not assign to variable.");
  852. }
  853. else
  854. return Error("Variable address not found.");
  855. }
  856. break;
  857. default:
  858. RMLUI_ERRORMSG("Instruction not implemented."); break;
  859. }
  860. return true;
  861. }
  862. };
  863. struct TestParser {
  864. TestParser() : model(type_register.GetTransformFuncRegister())
  865. {
  866. DataModelConstructor handle(&model, &type_register);
  867. handle.Bind("radius", &radius);
  868. handle.Bind("color_name", &color_name);
  869. handle.BindFunc("color_value", [this](Rml::Core::Variant& variant) {
  870. variant = ToString(color_value);
  871. });
  872. String result;
  873. result = TestExpression("!!10 - 1 ? 'hello' : 'world' | to_upper", "WORLD");
  874. result = TestExpression("(color_name) + (': rgba(' + color_value + ')')", "color: rgba(180, 100, 255, 255)");
  875. result = TestExpression("'hello world' | to_upper(5 + 12 == 17 ? 'yes' : 'no', 9*2)", "HELLO WORLD");
  876. result = TestExpression("true == false", "0");
  877. result = TestExpression("true != false", "1");
  878. result = TestExpression("true", "1");
  879. result = TestExpression("true || false ? true && 3==1+2 ? 'Absolutely!' : 'well..' : 'no'", "Absolutely!");
  880. result = TestExpression(R"('It\'s a fit')", R"(It's a fit)");
  881. result = TestExpression("2 * 2", "4");
  882. result = TestExpression("50000 / 1500", "33.333");
  883. result = TestExpression("5*1+2", "7");
  884. result = TestExpression("5*(1+2)", "15");
  885. result = TestExpression("2*(-2)/4", "-1");
  886. result = TestExpression("5.2 + 19 + 'px'", "24.2px");
  887. result = TestExpression("(radius | format(2)) + 'm'", "8.70m");
  888. result = TestExpression("radius < 10.5 ? 'smaller' : 'larger'", "smaller");
  889. TestAssignment("radius = 15");
  890. result = TestExpression("radius < 10.5 ? 'smaller' : 'larger'", "larger");
  891. TestAssignment("radius = 4; color_name = 'image-color'");
  892. result = TestExpression("radius == 4 && color_name == 'image-color'", "1");
  893. result = TestExpression("5 == 1 + 2*2 || 8 == 1 + 4 ? 'yes' : 'no'", "yes");
  894. result = TestExpression("!!('fa' + 'lse')", "0");
  895. result = TestExpression("!!('tr' + 'ue')", "1");
  896. result = TestExpression("'fox' + 'dog' ? 'FoxyDog' : 'hot' + 'dog' | to_upper", "HOTDOG");
  897. result = TestExpression("3.62345 | round", "4");
  898. result = TestExpression("3.62345 | format(0)", "4");
  899. result = TestExpression("3.62345 | format(2)", "3.62");
  900. result = TestExpression("3.62345 | format(10)", "3.6234500000");
  901. result = TestExpression("3.62345 | format(10, true)", "3.62345");
  902. result = TestExpression("3.62345 | round | format(2)", "4.00");
  903. result = TestExpression("3.0001 | format(2, false)", "3.00");
  904. result = TestExpression("3.0001 | format(2, true)", "3");
  905. result = TestExpression("0.2 + 3.42345 | round", "4");
  906. result = TestExpression("(3.42345 | round) + 0.2", "3.2");
  907. result = TestExpression("(3.42345 | format(0)) + 0.2", "30.2"); // Here, format(0) returns a string, so the + means string concatenation.
  908. }
  909. String TestExpression(String expression, String expected = String())
  910. {
  911. String result;
  912. DataExpressionInterface interface(&model, nullptr);
  913. DataParser parser(expression, interface);
  914. if (parser.Parse(false))
  915. {
  916. Program program = parser.ReleaseProgram();
  917. AddressList addresses = parser.ReleaseAddresses();
  918. DataInterpreter interpreter(program, addresses, interface);
  919. if (interpreter.Run())
  920. result = interpreter.Result().Get<String>();
  921. if (!expected.empty() && result != expected)
  922. {
  923. String program_str = interpreter.DumpProgram();
  924. Log::Message(Log::LT_WARNING, "%s", program_str.c_str());
  925. RMLUI_ERRORMSG("Got unexpected data parser result.");
  926. }
  927. }
  928. else
  929. {
  930. RMLUI_ERRORMSG("Could not parse expression.");
  931. }
  932. return result;
  933. };
  934. bool TestAssignment(String expression)
  935. {
  936. bool result = false;
  937. DataExpressionInterface interface(&model, nullptr);
  938. DataParser parser(expression, interface);
  939. if (parser.Parse(true))
  940. {
  941. Program program = parser.ReleaseProgram();
  942. AddressList addresses = parser.ReleaseAddresses();
  943. DataInterpreter interpreter(program, addresses, interface);
  944. result = interpreter.Run();
  945. }
  946. RMLUI_ASSERT(result);
  947. return result;
  948. };
  949. DataTypeRegister type_register;
  950. DataModel model;
  951. float radius = 8.7f;
  952. String color_name = "color";
  953. Colourb color_value = Colourb(180, 100, 255);
  954. };
  955. DataExpression::DataExpression(String expression) : expression(expression) {}
  956. DataExpression::~DataExpression()
  957. {
  958. }
  959. bool DataExpression::Parse(const DataExpressionInterface& expression_interface, bool is_assignment_expression)
  960. {
  961. // @todo: Remove, debugging only
  962. static TestParser test_parser;
  963. DataParser parser(expression, expression_interface);
  964. if (!parser.Parse(is_assignment_expression))
  965. return false;
  966. program = parser.ReleaseProgram();
  967. addresses = parser.ReleaseAddresses();
  968. return true;
  969. }
  970. bool DataExpression::Run(const DataExpressionInterface& expression_interface, Variant& out_value)
  971. {
  972. DataInterpreter interpreter(program, addresses, expression_interface);
  973. if (!interpreter.Run())
  974. return false;
  975. out_value = interpreter.Result();
  976. return true;
  977. }
  978. StringList DataExpression::GetVariableNameList() const
  979. {
  980. StringList list;
  981. list.reserve(addresses.size());
  982. for (const DataAddress& address : addresses)
  983. {
  984. if (!address.empty())
  985. list.push_back(address[0].name);
  986. }
  987. return list;
  988. }
  989. DataExpressionInterface::DataExpressionInterface(DataModel* data_model, Element* element, Event* event) : data_model(data_model), element(element), event(event)
  990. {}
  991. DataAddress DataExpressionInterface::ParseAddress(const String& address_str) const
  992. {
  993. if (address_str.size() >= 4 && address_str[0] == 'e' && address_str[1] == 'v' && address_str[2] == '.')
  994. return DataAddress{ DataAddressEntry("ev"), DataAddressEntry(address_str.substr(3)) };
  995. return data_model ? data_model->ResolveAddress(address_str, element) : DataAddress();
  996. }
  997. Variant DataExpressionInterface::GetValue(const DataAddress& address) const
  998. {
  999. Variant result;
  1000. if(event && address.size() == 2 && address.front().name == "ev")
  1001. {
  1002. auto& parameters = event->GetParameters();
  1003. auto it = parameters.find(address.back().name);
  1004. if (it != parameters.end())
  1005. result = it->second;
  1006. }
  1007. else if (data_model)
  1008. {
  1009. data_model->GetVariableInto(address, result);
  1010. }
  1011. return result;
  1012. }
  1013. bool DataExpressionInterface::SetValue(const DataAddress& address, const Variant& value) const
  1014. {
  1015. bool result = false;
  1016. if (data_model && !address.empty())
  1017. {
  1018. if (DataVariable variable = data_model->GetVariable(address))
  1019. result = variable.Set(value);
  1020. if (result)
  1021. data_model->DirtyVariable(address.front().name);
  1022. }
  1023. return result;
  1024. }
  1025. bool DataExpressionInterface::CallTransform(const String& name, Variant& inout_variant, const VariantList& arguments)
  1026. {
  1027. return data_model ? data_model->CallTransform(name, inout_variant, arguments) : false;
  1028. }
  1029. bool DataExpressionInterface::EventCallback(const String& name, const VariantList& arguments)
  1030. {
  1031. if (!data_model || !event)
  1032. return false;
  1033. const DataEventFunc* func = data_model->GetEventCallback(name);
  1034. if (!func || !*func)
  1035. return false;
  1036. DataModelHandle handle(data_model);
  1037. func->operator()(handle, *event, arguments);
  1038. return true;
  1039. }
  1040. }
  1041. }