String.cpp 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522
  1. /*************************************************************************/
  2. /* String.cpp */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2021 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 "String.hpp"
  31. #include "Array.hpp"
  32. #include "GodotGlobal.hpp"
  33. #include "NodePath.hpp"
  34. #include "PoolArrays.hpp"
  35. #include "Variant.hpp"
  36. #include <gdnative/string.h>
  37. #include <string.h>
  38. namespace godot {
  39. godot::CharString::~CharString() {
  40. godot::api->godot_char_string_destroy(&_char_string);
  41. }
  42. int godot::CharString::length() const {
  43. return godot::api->godot_char_string_length(&_char_string);
  44. }
  45. const char *godot::CharString::get_data() const {
  46. return godot::api->godot_char_string_get_data(&_char_string);
  47. }
  48. String String::num(double p_num, int p_decimals) {
  49. return String(godot::api->godot_string_num_with_decimals(p_num, p_decimals));
  50. }
  51. String String::num_scientific(double p_num) {
  52. return String(godot::api->godot_string_num_scientific(p_num));
  53. }
  54. String String::num_real(double p_num) {
  55. return String(godot::api->godot_string_num_real(p_num));
  56. }
  57. String String::num_int64(int64_t p_num, int base, bool capitalize_hex) {
  58. return String(godot::api->godot_string_num_int64_capitalized(p_num, base, capitalize_hex));
  59. }
  60. String String::chr(godot_char_type p_char) {
  61. return String(godot::api->godot_string_chr(p_char));
  62. }
  63. String String::md5(const uint8_t *p_md5) {
  64. return String(godot::api->godot_string_md5(p_md5));
  65. }
  66. String String::hex_encode_buffer(const uint8_t *p_buffer, int p_len) {
  67. return String(godot::api->godot_string_hex_encode_buffer(p_buffer, p_len));
  68. }
  69. godot::String::String() {
  70. godot::api->godot_string_new(&_godot_string);
  71. }
  72. String::String(const char *contents) {
  73. godot::api->godot_string_new(&_godot_string);
  74. godot::api->godot_string_parse_utf8(&_godot_string, contents);
  75. }
  76. String::String(const wchar_t *contents) {
  77. godot::api->godot_string_new_with_wide_string(&_godot_string, contents, wcslen(contents));
  78. }
  79. String::String(const wchar_t c) {
  80. godot::api->godot_string_new_with_wide_string(&_godot_string, &c, 1);
  81. }
  82. String::String(const String &other) {
  83. godot::api->godot_string_new_copy(&_godot_string, &other._godot_string);
  84. }
  85. String::String(String &&other) {
  86. godot::api->godot_string_new_copy(&_godot_string, &other._godot_string);
  87. }
  88. String::~String() {
  89. godot::api->godot_string_destroy(&_godot_string);
  90. }
  91. wchar_t &String::operator[](const int idx) {
  92. return *const_cast<wchar_t *>(godot::api->godot_string_operator_index(&_godot_string, idx));
  93. }
  94. wchar_t String::operator[](const int idx) const {
  95. return *godot::api->godot_string_operator_index((godot_string *)&_godot_string, idx);
  96. }
  97. int String::length() const {
  98. return godot::api->godot_string_length(&_godot_string);
  99. }
  100. void String::operator=(const String &s) {
  101. godot::api->godot_string_destroy(&_godot_string);
  102. godot::api->godot_string_new_copy(&_godot_string, &s._godot_string);
  103. }
  104. void String::operator=(String &&s) {
  105. godot::api->godot_string_destroy(&_godot_string);
  106. godot::api->godot_string_new_copy(&_godot_string, &s._godot_string);
  107. }
  108. bool String::operator==(const String &s) const {
  109. return godot::api->godot_string_operator_equal(&_godot_string, &s._godot_string);
  110. }
  111. bool String::operator!=(const String &s) const {
  112. return !(*this == s);
  113. }
  114. String String::operator+(const String &s) const {
  115. return String(godot::api->godot_string_operator_plus(&_godot_string, &s._godot_string));
  116. }
  117. void String::operator+=(const String &s) {
  118. *this = String(godot::api->godot_string_operator_plus(&_godot_string, &s._godot_string));
  119. }
  120. void String::operator+=(const wchar_t c) {
  121. String _to_be_added = String(c);
  122. *this = String(godot::api->godot_string_operator_plus(&_godot_string, &_to_be_added._godot_string));
  123. }
  124. bool String::operator<(const String &s) const {
  125. return godot::api->godot_string_operator_less(&_godot_string, &s._godot_string);
  126. }
  127. bool String::operator<=(const String &s) const {
  128. return godot::api->godot_string_operator_less(&_godot_string, &s._godot_string) ||
  129. (*this == s);
  130. }
  131. bool String::operator>(const String &s) const {
  132. return !(*this <= s);
  133. }
  134. bool String::operator>=(const String &s) const {
  135. return !(*this < s);
  136. }
  137. String::operator NodePath() const {
  138. return NodePath(*this);
  139. }
  140. const wchar_t *String::unicode_str() const {
  141. return godot::api->godot_string_wide_str(&_godot_string);
  142. }
  143. char *String::alloc_c_string() const {
  144. godot_char_string contents = godot::api->godot_string_utf8(&_godot_string);
  145. int length = godot::api->godot_char_string_length(&contents);
  146. char *result = (char *)godot::api->godot_alloc(length + 1);
  147. if (result) {
  148. memcpy(result, godot::api->godot_char_string_get_data(&contents), length + 1);
  149. }
  150. godot::api->godot_char_string_destroy(&contents);
  151. return result;
  152. }
  153. CharString String::utf8() const {
  154. CharString ret;
  155. ret._char_string = godot::api->godot_string_utf8(&_godot_string);
  156. return ret;
  157. }
  158. CharString String::ascii(bool p_extended) const {
  159. CharString ret;
  160. if (p_extended)
  161. ret._char_string = godot::api->godot_string_ascii_extended(&_godot_string);
  162. else
  163. ret._char_string = godot::api->godot_string_ascii(&_godot_string);
  164. return ret;
  165. }
  166. String operator+(const char *a, const String &b) {
  167. return String(a) + b;
  168. }
  169. String operator+(const wchar_t *a, const String &b) {
  170. return String(a) + b;
  171. }
  172. bool String::begins_with(String &p_string) const {
  173. return godot::api->godot_string_begins_with(&_godot_string, &p_string._godot_string);
  174. }
  175. bool String::begins_with_char_array(const char *p_char_array) const {
  176. return godot::api->godot_string_begins_with_char_array(&_godot_string, p_char_array);
  177. }
  178. PoolStringArray String::bigrams() const {
  179. godot_array arr = godot::api->godot_string_bigrams(&_godot_string);
  180. return Array(arr);
  181. }
  182. String String::c_escape() const {
  183. return String(godot::api->godot_string_c_escape(&_godot_string));
  184. }
  185. String String::c_unescape() const {
  186. return String(godot::api->godot_string_c_unescape(&_godot_string));
  187. }
  188. String String::capitalize() const {
  189. return String(godot::api->godot_string_capitalize(&_godot_string));
  190. }
  191. bool String::empty() const {
  192. return godot::api->godot_string_empty(&_godot_string);
  193. }
  194. bool String::ends_with(String &p_string) const {
  195. return godot::api->godot_string_ends_with(&_godot_string, &p_string._godot_string);
  196. }
  197. void String::erase(int position, int chars) {
  198. godot::api->godot_string_erase(&_godot_string, position, chars);
  199. }
  200. int String::find(String p_what, int p_from) const {
  201. return godot::api->godot_string_find_from(&_godot_string, p_what._godot_string, p_from);
  202. }
  203. int String::find_last(String p_what) const {
  204. return godot::api->godot_string_find_last(&_godot_string, p_what._godot_string);
  205. }
  206. int String::findn(String p_what, int p_from) const {
  207. return godot::api->godot_string_findn_from(&_godot_string, p_what._godot_string, p_from);
  208. }
  209. String String::format(Variant values) const {
  210. return String(godot::api->godot_string_format(&_godot_string, (godot_variant *)&values));
  211. }
  212. String String::format(Variant values, String placeholder) const {
  213. godot_char_string contents = godot::api->godot_string_utf8(&placeholder._godot_string);
  214. String new_string(godot::api->godot_string_format_with_custom_placeholder(&_godot_string, (godot_variant *)&values, godot::api->godot_char_string_get_data(&contents)));
  215. godot::api->godot_char_string_destroy(&contents);
  216. return new_string;
  217. }
  218. String String::get_base_dir() const {
  219. return String(godot::api->godot_string_get_base_dir(&_godot_string));
  220. }
  221. String String::get_basename() const {
  222. return String(godot::api->godot_string_get_basename(&_godot_string));
  223. }
  224. String String::get_extension() const {
  225. return String(godot::api->godot_string_get_extension(&_godot_string));
  226. }
  227. String String::get_file() const {
  228. return String(godot::api->godot_string_get_file(&_godot_string));
  229. }
  230. int String::hash() const {
  231. return godot::api->godot_string_hash(&_godot_string);
  232. }
  233. int String::hex_to_int() const {
  234. return godot::api->godot_string_hex_to_int(&_godot_string);
  235. }
  236. String String::insert(int position, String what) const {
  237. return String(godot::api->godot_string_insert(&_godot_string, position, what._godot_string));
  238. }
  239. bool String::is_abs_path() const {
  240. return godot::api->godot_string_is_abs_path(&_godot_string);
  241. }
  242. bool String::is_rel_path() const {
  243. return godot::api->godot_string_is_rel_path(&_godot_string);
  244. }
  245. bool String::is_subsequence_of(String text) const {
  246. return godot::api->godot_string_is_subsequence_of(&_godot_string, &text._godot_string);
  247. }
  248. bool String::is_subsequence_ofi(String text) const {
  249. return godot::api->godot_string_is_subsequence_ofi(&_godot_string, &text._godot_string);
  250. }
  251. bool String::is_valid_float() const {
  252. return godot::api->godot_string_is_valid_float(&_godot_string);
  253. }
  254. bool String::is_valid_html_color() const {
  255. return godot::api->godot_string_is_valid_html_color(&_godot_string);
  256. }
  257. bool String::is_valid_identifier() const {
  258. return godot::api->godot_string_is_valid_identifier(&_godot_string);
  259. }
  260. bool String::is_valid_integer() const {
  261. return godot::api->godot_string_is_numeric(&_godot_string);
  262. }
  263. bool String::is_valid_ip_address() const {
  264. return godot::api->godot_string_is_valid_ip_address(&_godot_string);
  265. }
  266. String String::json_escape() const {
  267. return String(godot::api->godot_string_json_escape(&_godot_string));
  268. }
  269. String String::left(int position) const {
  270. return String(godot::api->godot_string_left(&_godot_string, position));
  271. }
  272. bool String::match(String expr) const {
  273. return godot::api->godot_string_match(&_godot_string, &expr._godot_string);
  274. }
  275. bool String::matchn(String expr) const {
  276. return godot::api->godot_string_match(&_godot_string, &expr._godot_string);
  277. }
  278. PoolByteArray String::md5_buffer() const {
  279. godot_pool_byte_array arr = godot::api->godot_string_md5_buffer(&_godot_string);
  280. return PoolByteArray(arr);
  281. }
  282. String String::md5_text() const {
  283. return String(godot::api->godot_string_md5_text(&_godot_string));
  284. }
  285. int String::ord_at(int at) const {
  286. return godot::api->godot_string_ord_at(&_godot_string, at);
  287. }
  288. String String::pad_decimals(int digits) const {
  289. return String(godot::api->godot_string_pad_decimals(&_godot_string, digits));
  290. }
  291. String String::pad_zeros(int digits) const {
  292. return String(godot::api->godot_string_pad_zeros(&_godot_string, digits));
  293. }
  294. String String::percent_decode() const {
  295. return String(godot::api->godot_string_percent_decode(&_godot_string));
  296. }
  297. String String::percent_encode() const {
  298. return String(godot::api->godot_string_percent_encode(&_godot_string));
  299. }
  300. String String::plus_file(String file) const {
  301. return String(godot::api->godot_string_plus_file(&_godot_string, &file._godot_string));
  302. }
  303. String String::replace(String p_key, String p_with) const {
  304. return String(godot::api->godot_string_replace(&_godot_string, p_key._godot_string, p_with._godot_string));
  305. }
  306. String String::replacen(String what, String forwhat) const {
  307. return String(godot::api->godot_string_replacen(&_godot_string, what._godot_string, forwhat._godot_string));
  308. }
  309. int String::rfind(String p_what, int p_from) const {
  310. return godot::api->godot_string_rfind_from(&_godot_string, p_what._godot_string, p_from);
  311. }
  312. int String::rfindn(String p_what, int p_from) const {
  313. return godot::api->godot_string_rfindn_from(&_godot_string, p_what._godot_string, p_from);
  314. }
  315. String String::right(int position) const {
  316. return String(godot::api->godot_string_right(&_godot_string, position));
  317. }
  318. PoolByteArray String::sha256_buffer() const {
  319. godot_pool_byte_array arr = godot::api->godot_string_sha256_buffer(&_godot_string);
  320. return PoolByteArray(arr);
  321. }
  322. String String::sha256_text() const {
  323. return String(godot::api->godot_string_sha256_text(&_godot_string));
  324. }
  325. float String::similarity(String text) const {
  326. return godot::api->godot_string_similarity(&_godot_string, &text._godot_string);
  327. }
  328. // TODO Suport allow_empty
  329. PoolStringArray String::split(String divisor, bool /*allow_empty*/) const {
  330. godot_array arr = godot::api->godot_string_split(&_godot_string, &divisor._godot_string);
  331. return Array(arr);
  332. }
  333. // TODO Suport allow_empty
  334. PoolIntArray String::split_ints(String divisor, bool /*allow_empty*/) const {
  335. godot_array arr = godot::api->godot_string_split_floats(&_godot_string, &divisor._godot_string);
  336. return Array(arr);
  337. }
  338. // TODO Suport allow_empty
  339. PoolRealArray String::split_floats(String divisor, bool /*allow_empty*/) const {
  340. // TODO The GDNative API returns godot_array, when according to the doc, it should have been godot_pool_real_array
  341. godot_array arr = godot::api->godot_string_split_floats(&_godot_string, &divisor._godot_string);
  342. Array wrapped_array(arr);
  343. return PoolRealArray(wrapped_array);
  344. }
  345. String String::strip_edges(bool left, bool right) const {
  346. return String(godot::api->godot_string_strip_edges(&_godot_string, left, right));
  347. }
  348. String String::substr(int from, int len) const {
  349. return String(godot::api->godot_string_substr(&_godot_string, from, len));
  350. }
  351. float String::to_float() const {
  352. return godot::api->godot_string_to_float(&_godot_string);
  353. }
  354. int64_t String::to_int() const {
  355. return godot::api->godot_string_to_int(&_godot_string);
  356. }
  357. String String::to_lower() const {
  358. return String(godot::api->godot_string_to_lower(&_godot_string));
  359. }
  360. String String::to_upper() const {
  361. return String(godot::api->godot_string_to_upper(&_godot_string));
  362. }
  363. String String::xml_escape() const {
  364. return String(godot::api->godot_string_xml_escape(&_godot_string));
  365. }
  366. String String::xml_unescape() const {
  367. return String(godot::api->godot_string_xml_unescape(&_godot_string));
  368. }
  369. signed char String::casecmp_to(String p_str) const {
  370. return godot::api->godot_string_casecmp_to(&_godot_string, &p_str._godot_string);
  371. }
  372. signed char String::nocasecmp_to(String p_str) const {
  373. return godot::api->godot_string_nocasecmp_to(&_godot_string, &p_str._godot_string);
  374. }
  375. signed char String::naturalnocasecmp_to(String p_str) const {
  376. return godot::api->godot_string_naturalnocasecmp_to(&_godot_string, &p_str._godot_string);
  377. }
  378. String String::dedent() const {
  379. godot_string s = godot::core_1_1_api->godot_string_dedent(&_godot_string);
  380. return String(s);
  381. }
  382. PoolStringArray String::rsplit(const String &divisor, const bool allow_empty, const int maxsplit) const {
  383. godot_pool_string_array arr =
  384. godot::core_1_1_api->godot_string_rsplit(&_godot_string, &divisor._godot_string, allow_empty, maxsplit);
  385. return PoolStringArray(arr);
  386. }
  387. String String::rstrip(const String &chars) const {
  388. godot_string s = godot::core_1_1_api->godot_string_rstrip(&_godot_string, &chars._godot_string);
  389. return String(s);
  390. }
  391. String String::trim_prefix(const String &prefix) const {
  392. godot_string s = godot::core_1_1_api->godot_string_trim_prefix(&_godot_string, &prefix._godot_string);
  393. return String(s);
  394. }
  395. String String::trim_suffix(const String &suffix) const {
  396. godot_string s = godot::core_1_1_api->godot_string_trim_suffix(&_godot_string, &suffix._godot_string);
  397. return String(s);
  398. }
  399. } // namespace godot