SDL_string.c 51 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958
  1. /*
  2. Simple DirectMedia Layer
  3. Copyright (C) 1997-2022 Sam Lantinga <slouken@libsdl.org>
  4. This software is provided 'as-is', without any express or implied
  5. warranty. In no event will the authors be held liable for any damages
  6. arising from the use of this software.
  7. Permission is granted to anyone to use this software for any purpose,
  8. including commercial applications, and to alter it and redistribute it
  9. freely, subject to the following restrictions:
  10. 1. The origin of this software must not be misrepresented; you must not
  11. claim that you wrote the original software. If you use this software
  12. in a product, an acknowledgment in the product documentation would be
  13. appreciated but is not required.
  14. 2. Altered source versions must be plainly marked as such, and must not be
  15. misrepresented as being the original software.
  16. 3. This notice may not be removed or altered from any source distribution.
  17. */
  18. #if defined(__clang_analyzer__)
  19. #define SDL_DISABLE_ANALYZE_MACROS 1
  20. #endif
  21. #include "../SDL_internal.h"
  22. /* This file contains portable string manipulation functions for SDL */
  23. #include "SDL_stdinc.h"
  24. #if !defined(HAVE_VSSCANF) || !defined(HAVE_STRTOL) || !defined(HAVE_STRTOUL) || !defined(HAVE_STRTOD) || !defined(HAVE_STRTOLL) || !defined(HAVE_STRTOULL)
  25. #define SDL_isupperhex(X) (((X) >= 'A') && ((X) <= 'F'))
  26. #define SDL_islowerhex(X) (((X) >= 'a') && ((X) <= 'f'))
  27. #endif
  28. #define UTF8_IsLeadByte(c) ((c) >= 0xC0 && (c) <= 0xF4)
  29. #define UTF8_IsTrailingByte(c) ((c) >= 0x80 && (c) <= 0xBF)
  30. static unsigned UTF8_TrailingBytes(unsigned char c)
  31. {
  32. if (c >= 0xC0 && c <= 0xDF)
  33. return 1;
  34. else if (c >= 0xE0 && c <= 0xEF)
  35. return 2;
  36. else if (c >= 0xF0 && c <= 0xF4)
  37. return 3;
  38. else
  39. return 0;
  40. }
  41. #if !defined(HAVE_VSSCANF) || !defined(HAVE_STRTOL)
  42. static size_t
  43. SDL_ScanLong(const char *text, int radix, long *valuep)
  44. {
  45. const char *textstart = text;
  46. long value = 0;
  47. SDL_bool negative = SDL_FALSE;
  48. if (*text == '-') {
  49. negative = SDL_TRUE;
  50. ++text;
  51. }
  52. if (radix == 16 && SDL_strncmp(text, "0x", 2) == 0) {
  53. text += 2;
  54. }
  55. for (;;) {
  56. int v;
  57. if (SDL_isdigit((unsigned char) *text)) {
  58. v = *text - '0';
  59. } else if (radix == 16 && SDL_isupperhex(*text)) {
  60. v = 10 + (*text - 'A');
  61. } else if (radix == 16 && SDL_islowerhex(*text)) {
  62. v = 10 + (*text - 'a');
  63. } else {
  64. break;
  65. }
  66. value *= radix;
  67. value += v;
  68. ++text;
  69. }
  70. if (valuep && text > textstart) {
  71. if (negative && value) {
  72. *valuep = -value;
  73. } else {
  74. *valuep = value;
  75. }
  76. }
  77. return (text - textstart);
  78. }
  79. #endif
  80. #if !defined(HAVE_VSSCANF) || !defined(HAVE_STRTOUL) || !defined(HAVE_STRTOD)
  81. static size_t
  82. SDL_ScanUnsignedLong(const char *text, int radix, unsigned long *valuep)
  83. {
  84. const char *textstart = text;
  85. unsigned long value = 0;
  86. if (radix == 16 && SDL_strncmp(text, "0x", 2) == 0) {
  87. text += 2;
  88. }
  89. for (;;) {
  90. int v;
  91. if (SDL_isdigit((unsigned char) *text)) {
  92. v = *text - '0';
  93. } else if (radix == 16 && SDL_isupperhex(*text)) {
  94. v = 10 + (*text - 'A');
  95. } else if (radix == 16 && SDL_islowerhex(*text)) {
  96. v = 10 + (*text - 'a');
  97. } else {
  98. break;
  99. }
  100. value *= radix;
  101. value += v;
  102. ++text;
  103. }
  104. if (valuep && text > textstart) {
  105. *valuep = value;
  106. }
  107. return (text - textstart);
  108. }
  109. #endif
  110. #ifndef HAVE_VSSCANF
  111. static size_t
  112. SDL_ScanUintPtrT(const char *text, int radix, uintptr_t * valuep)
  113. {
  114. const char *textstart = text;
  115. uintptr_t value = 0;
  116. if (radix == 16 && SDL_strncmp(text, "0x", 2) == 0) {
  117. text += 2;
  118. }
  119. for (;;) {
  120. int v;
  121. if (SDL_isdigit((unsigned char) *text)) {
  122. v = *text - '0';
  123. } else if (radix == 16 && SDL_isupperhex(*text)) {
  124. v = 10 + (*text - 'A');
  125. } else if (radix == 16 && SDL_islowerhex(*text)) {
  126. v = 10 + (*text - 'a');
  127. } else {
  128. break;
  129. }
  130. value *= radix;
  131. value += v;
  132. ++text;
  133. }
  134. if (valuep && text > textstart) {
  135. *valuep = value;
  136. }
  137. return (text - textstart);
  138. }
  139. #endif
  140. #if !defined(HAVE_VSSCANF) || !defined(HAVE_STRTOLL)
  141. static size_t
  142. SDL_ScanLongLong(const char *text, int radix, Sint64 * valuep)
  143. {
  144. const char *textstart = text;
  145. Sint64 value = 0;
  146. SDL_bool negative = SDL_FALSE;
  147. if (*text == '-') {
  148. negative = SDL_TRUE;
  149. ++text;
  150. }
  151. if (radix == 16 && SDL_strncmp(text, "0x", 2) == 0) {
  152. text += 2;
  153. }
  154. for (;;) {
  155. int v;
  156. if (SDL_isdigit((unsigned char) *text)) {
  157. v = *text - '0';
  158. } else if (radix == 16 && SDL_isupperhex(*text)) {
  159. v = 10 + (*text - 'A');
  160. } else if (radix == 16 && SDL_islowerhex(*text)) {
  161. v = 10 + (*text - 'a');
  162. } else {
  163. break;
  164. }
  165. value *= radix;
  166. value += v;
  167. ++text;
  168. }
  169. if (valuep && text > textstart) {
  170. if (negative && value) {
  171. *valuep = -value;
  172. } else {
  173. *valuep = value;
  174. }
  175. }
  176. return (text - textstart);
  177. }
  178. #endif
  179. #if !defined(HAVE_VSSCANF) || !defined(HAVE_STRTOULL)
  180. static size_t
  181. SDL_ScanUnsignedLongLong(const char *text, int radix, Uint64 * valuep)
  182. {
  183. const char *textstart = text;
  184. Uint64 value = 0;
  185. if (radix == 16 && SDL_strncmp(text, "0x", 2) == 0) {
  186. text += 2;
  187. }
  188. for (;;) {
  189. int v;
  190. if (SDL_isdigit((unsigned char) *text)) {
  191. v = *text - '0';
  192. } else if (radix == 16 && SDL_isupperhex(*text)) {
  193. v = 10 + (*text - 'A');
  194. } else if (radix == 16 && SDL_islowerhex(*text)) {
  195. v = 10 + (*text - 'a');
  196. } else {
  197. break;
  198. }
  199. value *= radix;
  200. value += v;
  201. ++text;
  202. }
  203. if (valuep && text > textstart) {
  204. *valuep = value;
  205. }
  206. return (text - textstart);
  207. }
  208. #endif
  209. #if !defined(HAVE_VSSCANF) || !defined(HAVE_STRTOD)
  210. static size_t
  211. SDL_ScanFloat(const char *text, double *valuep)
  212. {
  213. const char *textstart = text;
  214. unsigned long lvalue = 0;
  215. double value = 0.0;
  216. SDL_bool negative = SDL_FALSE;
  217. if (*text == '-') {
  218. negative = SDL_TRUE;
  219. ++text;
  220. }
  221. text += SDL_ScanUnsignedLong(text, 10, &lvalue);
  222. value += lvalue;
  223. if (*text == '.') {
  224. int mult = 10;
  225. ++text;
  226. while (SDL_isdigit((unsigned char) *text)) {
  227. lvalue = *text - '0';
  228. value += (double) lvalue / mult;
  229. mult *= 10;
  230. ++text;
  231. }
  232. }
  233. if (valuep && text > textstart) {
  234. if (negative && value) {
  235. *valuep = -value;
  236. } else {
  237. *valuep = value;
  238. }
  239. }
  240. return (text - textstart);
  241. }
  242. #endif
  243. void *
  244. SDL_memset(SDL_OUT_BYTECAP(len) void *dst, int c, size_t len)
  245. {
  246. #if defined(HAVE_MEMSET)
  247. return memset(dst, c, len);
  248. #else
  249. size_t left;
  250. Uint32 *dstp4;
  251. Uint8 *dstp1 = (Uint8 *) dst;
  252. Uint8 value1;
  253. Uint32 value4;
  254. /* The value used in memset() is a byte, passed as an int */
  255. c &= 0xff;
  256. /* The destination pointer needs to be aligned on a 4-byte boundary to
  257. * execute a 32-bit set. Set first bytes manually if needed until it is
  258. * aligned. */
  259. value1 = (Uint8)c;
  260. while ((uintptr_t)dstp1 & 0x3) {
  261. if (len--) {
  262. *dstp1++ = value1;
  263. } else {
  264. return dst;
  265. }
  266. }
  267. value4 = ((Uint32)c | ((Uint32)c << 8) | ((Uint32)c << 16) | ((Uint32)c << 24));
  268. dstp4 = (Uint32 *) dstp1;
  269. left = (len % 4);
  270. len /= 4;
  271. while (len--) {
  272. *dstp4++ = value4;
  273. }
  274. dstp1 = (Uint8 *) dstp4;
  275. switch (left) {
  276. case 3:
  277. *dstp1++ = value1;
  278. case 2:
  279. *dstp1++ = value1;
  280. case 1:
  281. *dstp1++ = value1;
  282. }
  283. return dst;
  284. #endif /* HAVE_MEMSET */
  285. }
  286. void *
  287. SDL_memcpy(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len)
  288. {
  289. #ifdef __GNUC__
  290. /* Presumably this is well tuned for speed.
  291. On my machine this is twice as fast as the C code below.
  292. */
  293. return __builtin_memcpy(dst, src, len);
  294. #elif defined(HAVE_MEMCPY)
  295. return memcpy(dst, src, len);
  296. #elif defined(HAVE_BCOPY)
  297. bcopy(src, dst, len);
  298. return dst;
  299. #else
  300. /* GCC 4.9.0 with -O3 will generate movaps instructions with the loop
  301. using Uint32* pointers, so we need to make sure the pointers are
  302. aligned before we loop using them.
  303. */
  304. if (((uintptr_t)src & 0x3) || ((uintptr_t)dst & 0x3)) {
  305. /* Do an unaligned byte copy */
  306. Uint8 *srcp1 = (Uint8 *)src;
  307. Uint8 *dstp1 = (Uint8 *)dst;
  308. while (len--) {
  309. *dstp1++ = *srcp1++;
  310. }
  311. } else {
  312. size_t left = (len % 4);
  313. Uint32 *srcp4, *dstp4;
  314. Uint8 *srcp1, *dstp1;
  315. srcp4 = (Uint32 *) src;
  316. dstp4 = (Uint32 *) dst;
  317. len /= 4;
  318. while (len--) {
  319. *dstp4++ = *srcp4++;
  320. }
  321. srcp1 = (Uint8 *) srcp4;
  322. dstp1 = (Uint8 *) dstp4;
  323. switch (left) {
  324. case 3:
  325. *dstp1++ = *srcp1++;
  326. case 2:
  327. *dstp1++ = *srcp1++;
  328. case 1:
  329. *dstp1++ = *srcp1++;
  330. }
  331. }
  332. return dst;
  333. #endif /* __GNUC__ */
  334. }
  335. void *
  336. SDL_memmove(SDL_OUT_BYTECAP(len) void *dst, SDL_IN_BYTECAP(len) const void *src, size_t len)
  337. {
  338. #if defined(HAVE_MEMMOVE)
  339. return memmove(dst, src, len);
  340. #else
  341. char *srcp = (char *) src;
  342. char *dstp = (char *) dst;
  343. if (src < dst) {
  344. srcp += len - 1;
  345. dstp += len - 1;
  346. while (len--) {
  347. *dstp-- = *srcp--;
  348. }
  349. } else {
  350. while (len--) {
  351. *dstp++ = *srcp++;
  352. }
  353. }
  354. return dst;
  355. #endif /* HAVE_MEMMOVE */
  356. }
  357. int
  358. SDL_memcmp(const void *s1, const void *s2, size_t len)
  359. {
  360. #if defined(HAVE_MEMCMP)
  361. return memcmp(s1, s2, len);
  362. #else
  363. char *s1p = (char *) s1;
  364. char *s2p = (char *) s2;
  365. while (len--) {
  366. if (*s1p != *s2p) {
  367. return (*s1p - *s2p);
  368. }
  369. ++s1p;
  370. ++s2p;
  371. }
  372. return 0;
  373. #endif /* HAVE_MEMCMP */
  374. }
  375. size_t
  376. SDL_strlen(const char *string)
  377. {
  378. #if defined(HAVE_STRLEN)
  379. return strlen(string);
  380. #else
  381. size_t len = 0;
  382. while (*string++) {
  383. ++len;
  384. }
  385. return len;
  386. #endif /* HAVE_STRLEN */
  387. }
  388. size_t
  389. SDL_wcslen(const wchar_t * string)
  390. {
  391. #if defined(HAVE_WCSLEN)
  392. return wcslen(string);
  393. #else
  394. size_t len = 0;
  395. while (*string++) {
  396. ++len;
  397. }
  398. return len;
  399. #endif /* HAVE_WCSLEN */
  400. }
  401. size_t
  402. SDL_wcslcpy(SDL_OUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen)
  403. {
  404. #if defined(HAVE_WCSLCPY)
  405. return wcslcpy(dst, src, maxlen);
  406. #else
  407. size_t srclen = SDL_wcslen(src);
  408. if (maxlen > 0) {
  409. size_t len = SDL_min(srclen, maxlen - 1);
  410. SDL_memcpy(dst, src, len * sizeof(wchar_t));
  411. dst[len] = '\0';
  412. }
  413. return srclen;
  414. #endif /* HAVE_WCSLCPY */
  415. }
  416. size_t
  417. SDL_wcslcat(SDL_INOUT_Z_CAP(maxlen) wchar_t *dst, const wchar_t *src, size_t maxlen)
  418. {
  419. #if defined(HAVE_WCSLCAT)
  420. return wcslcat(dst, src, maxlen);
  421. #else
  422. size_t dstlen = SDL_wcslen(dst);
  423. size_t srclen = SDL_wcslen(src);
  424. if (dstlen < maxlen) {
  425. SDL_wcslcpy(dst + dstlen, src, maxlen - dstlen);
  426. }
  427. return dstlen + srclen;
  428. #endif /* HAVE_WCSLCAT */
  429. }
  430. wchar_t *
  431. SDL_wcsdup(const wchar_t *string)
  432. {
  433. size_t len = ((SDL_wcslen(string) + 1) * sizeof(wchar_t));
  434. wchar_t *newstr = (wchar_t *)SDL_malloc(len);
  435. if (newstr) {
  436. SDL_memcpy(newstr, string, len);
  437. }
  438. return newstr;
  439. }
  440. wchar_t *
  441. SDL_wcsstr(const wchar_t *haystack, const wchar_t *needle)
  442. {
  443. #if defined(HAVE_WCSSTR)
  444. return SDL_const_cast(wchar_t*,wcsstr(haystack, needle));
  445. #else
  446. size_t length = SDL_wcslen(needle);
  447. while (*haystack) {
  448. if (SDL_wcsncmp(haystack, needle, length) == 0) {
  449. return (wchar_t *)haystack;
  450. }
  451. ++haystack;
  452. }
  453. return NULL;
  454. #endif /* HAVE_WCSSTR */
  455. }
  456. int
  457. SDL_wcscmp(const wchar_t *str1, const wchar_t *str2)
  458. {
  459. #if defined(HAVE_WCSCMP)
  460. return wcscmp(str1, str2);
  461. #else
  462. while (*str1 && *str2) {
  463. if (*str1 != *str2)
  464. break;
  465. ++str1;
  466. ++str2;
  467. }
  468. return (int)(*str1 - *str2);
  469. #endif /* HAVE_WCSCMP */
  470. }
  471. int
  472. SDL_wcsncmp(const wchar_t *str1, const wchar_t *str2, size_t maxlen)
  473. {
  474. #if defined(HAVE_WCSNCMP)
  475. return wcsncmp(str1, str2, maxlen);
  476. #else
  477. while (*str1 && *str2 && maxlen) {
  478. if (*str1 != *str2)
  479. break;
  480. ++str1;
  481. ++str2;
  482. --maxlen;
  483. }
  484. if (!maxlen) {
  485. return 0;
  486. }
  487. return (int) (*str1 - *str2);
  488. #endif /* HAVE_WCSNCMP */
  489. }
  490. int
  491. SDL_wcscasecmp(const wchar_t *str1, const wchar_t *str2)
  492. {
  493. #if defined(HAVE_WCSCASECMP)
  494. return wcscasecmp(str1, str2);
  495. #elif defined(HAVE__WCSICMP)
  496. return _wcsicmp(str1, str2);
  497. #else
  498. wchar_t a = 0;
  499. wchar_t b = 0;
  500. while (*str1 && *str2) {
  501. /* FIXME: This doesn't actually support wide characters */
  502. if (*str1 >= 0x80 || *str2 >= 0x80) {
  503. a = *str1;
  504. b = *str2;
  505. } else {
  506. a = SDL_toupper((unsigned char) *str1);
  507. b = SDL_toupper((unsigned char) *str2);
  508. }
  509. if (a != b)
  510. break;
  511. ++str1;
  512. ++str2;
  513. }
  514. /* FIXME: This doesn't actually support wide characters */
  515. if (*str1 >= 0x80 || *str2 >= 0x80) {
  516. a = *str1;
  517. b = *str2;
  518. } else {
  519. a = SDL_toupper((unsigned char) *str1);
  520. b = SDL_toupper((unsigned char) *str2);
  521. }
  522. return (int) ((unsigned int) a - (unsigned int) b);
  523. #endif /* HAVE__WCSICMP */
  524. }
  525. int
  526. SDL_wcsncasecmp(const wchar_t *str1, const wchar_t *str2, size_t maxlen)
  527. {
  528. #if defined(HAVE_WCSNCASECMP)
  529. return wcsncasecmp(str1, str2, maxlen);
  530. #elif defined(HAVE__WCSNICMP)
  531. return _wcsnicmp(str1, str2, maxlen);
  532. #else
  533. wchar_t a = 0;
  534. wchar_t b = 0;
  535. while (*str1 && *str2 && maxlen) {
  536. /* FIXME: This doesn't actually support wide characters */
  537. if (*str1 >= 0x80 || *str2 >= 0x80) {
  538. a = *str1;
  539. b = *str2;
  540. } else {
  541. a = SDL_toupper((unsigned char) *str1);
  542. b = SDL_toupper((unsigned char) *str2);
  543. }
  544. if (a != b)
  545. break;
  546. ++str1;
  547. ++str2;
  548. --maxlen;
  549. }
  550. if (maxlen == 0) {
  551. return 0;
  552. } else {
  553. /* FIXME: This doesn't actually support wide characters */
  554. if (*str1 >= 0x80 || *str2 >= 0x80) {
  555. a = *str1;
  556. b = *str2;
  557. } else {
  558. a = SDL_toupper((unsigned char) *str1);
  559. b = SDL_toupper((unsigned char) *str2);
  560. }
  561. return (int) ((unsigned int) a - (unsigned int) b);
  562. }
  563. #endif /* HAVE__WCSNICMP */
  564. }
  565. size_t
  566. SDL_strlcpy(SDL_OUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen)
  567. {
  568. #if defined(HAVE_STRLCPY)
  569. return strlcpy(dst, src, maxlen);
  570. #else
  571. size_t srclen = SDL_strlen(src);
  572. if (maxlen > 0) {
  573. size_t len = SDL_min(srclen, maxlen - 1);
  574. SDL_memcpy(dst, src, len);
  575. dst[len] = '\0';
  576. }
  577. return srclen;
  578. #endif /* HAVE_STRLCPY */
  579. }
  580. size_t
  581. SDL_utf8strlcpy(SDL_OUT_Z_CAP(dst_bytes) char *dst, const char *src, size_t dst_bytes)
  582. {
  583. size_t src_bytes = SDL_strlen(src);
  584. size_t bytes = SDL_min(src_bytes, dst_bytes - 1);
  585. size_t i = 0;
  586. unsigned char trailing_bytes = 0;
  587. if (bytes) {
  588. unsigned char c = (unsigned char)src[bytes - 1];
  589. if (UTF8_IsLeadByte(c)) {
  590. --bytes;
  591. } else if (UTF8_IsTrailingByte(c)) {
  592. for (i = bytes - 1; i != 0; --i) {
  593. c = (unsigned char)src[i];
  594. trailing_bytes = UTF8_TrailingBytes(c);
  595. if (trailing_bytes) {
  596. if (bytes - i != trailing_bytes + 1)
  597. bytes = i;
  598. break;
  599. }
  600. }
  601. }
  602. SDL_memcpy(dst, src, bytes);
  603. }
  604. dst[bytes] = '\0';
  605. return bytes;
  606. }
  607. size_t
  608. SDL_utf8strlen(const char *str)
  609. {
  610. size_t retval = 0;
  611. const char *p = str;
  612. unsigned char ch;
  613. while ((ch = *(p++)) != 0) {
  614. /* if top two bits are 1 and 0, it's a continuation byte. */
  615. if ((ch & 0xc0) != 0x80) {
  616. retval++;
  617. }
  618. }
  619. return retval;
  620. }
  621. size_t
  622. SDL_strlcat(SDL_INOUT_Z_CAP(maxlen) char *dst, const char *src, size_t maxlen)
  623. {
  624. #if defined(HAVE_STRLCAT)
  625. return strlcat(dst, src, maxlen);
  626. #else
  627. size_t dstlen = SDL_strlen(dst);
  628. size_t srclen = SDL_strlen(src);
  629. if (dstlen < maxlen) {
  630. SDL_strlcpy(dst + dstlen, src, maxlen - dstlen);
  631. }
  632. return dstlen + srclen;
  633. #endif /* HAVE_STRLCAT */
  634. }
  635. char *
  636. SDL_strdup(const char *string)
  637. {
  638. size_t len = SDL_strlen(string) + 1;
  639. char *newstr = (char *)SDL_malloc(len);
  640. if (newstr) {
  641. SDL_memcpy(newstr, string, len);
  642. }
  643. return newstr;
  644. }
  645. char *
  646. SDL_strrev(char *string)
  647. {
  648. #if defined(HAVE__STRREV)
  649. return _strrev(string);
  650. #else
  651. size_t len = SDL_strlen(string);
  652. char *a = &string[0];
  653. char *b = &string[len - 1];
  654. len /= 2;
  655. while (len--) {
  656. char c = *a;
  657. *a++ = *b;
  658. *b-- = c;
  659. }
  660. return string;
  661. #endif /* HAVE__STRREV */
  662. }
  663. char *
  664. SDL_strupr(char *string)
  665. {
  666. #if defined(HAVE__STRUPR)
  667. return _strupr(string);
  668. #else
  669. char *bufp = string;
  670. while (*bufp) {
  671. *bufp = SDL_toupper((unsigned char) *bufp);
  672. ++bufp;
  673. }
  674. return string;
  675. #endif /* HAVE__STRUPR */
  676. }
  677. char *
  678. SDL_strlwr(char *string)
  679. {
  680. #if defined(HAVE__STRLWR)
  681. return _strlwr(string);
  682. #else
  683. char *bufp = string;
  684. while (*bufp) {
  685. *bufp = SDL_tolower((unsigned char) *bufp);
  686. ++bufp;
  687. }
  688. return string;
  689. #endif /* HAVE__STRLWR */
  690. }
  691. char *
  692. SDL_strchr(const char *string, int c)
  693. {
  694. #ifdef HAVE_STRCHR
  695. return SDL_const_cast(char*,strchr(string, c));
  696. #elif defined(HAVE_INDEX)
  697. return SDL_const_cast(char*,index(string, c));
  698. #else
  699. while (*string) {
  700. if (*string == c) {
  701. return (char *) string;
  702. }
  703. ++string;
  704. }
  705. return NULL;
  706. #endif /* HAVE_STRCHR */
  707. }
  708. char *
  709. SDL_strrchr(const char *string, int c)
  710. {
  711. #ifdef HAVE_STRRCHR
  712. return SDL_const_cast(char*,strrchr(string, c));
  713. #elif defined(HAVE_RINDEX)
  714. return SDL_const_cast(char*,rindex(string, c));
  715. #else
  716. const char *bufp = string + SDL_strlen(string) - 1;
  717. while (bufp >= string) {
  718. if (*bufp == c) {
  719. return (char *) bufp;
  720. }
  721. --bufp;
  722. }
  723. return NULL;
  724. #endif /* HAVE_STRRCHR */
  725. }
  726. char *
  727. SDL_strstr(const char *haystack, const char *needle)
  728. {
  729. #if defined(HAVE_STRSTR)
  730. return SDL_const_cast(char*,strstr(haystack, needle));
  731. #else
  732. size_t length = SDL_strlen(needle);
  733. while (*haystack) {
  734. if (SDL_strncmp(haystack, needle, length) == 0) {
  735. return (char *) haystack;
  736. }
  737. ++haystack;
  738. }
  739. return NULL;
  740. #endif /* HAVE_STRSTR */
  741. }
  742. #if !defined(HAVE__LTOA) || !defined(HAVE__I64TOA) || \
  743. !defined(HAVE__ULTOA) || !defined(HAVE__UI64TOA)
  744. static const char ntoa_table[] = {
  745. '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
  746. 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J',
  747. 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T',
  748. 'U', 'V', 'W', 'X', 'Y', 'Z'
  749. };
  750. #endif /* ntoa() conversion table */
  751. char *
  752. SDL_itoa(int value, char *string, int radix)
  753. {
  754. #ifdef HAVE_ITOA
  755. return itoa(value, string, radix);
  756. #else
  757. return SDL_ltoa((long)value, string, radix);
  758. #endif /* HAVE_ITOA */
  759. }
  760. char *
  761. SDL_uitoa(unsigned int value, char *string, int radix)
  762. {
  763. #ifdef HAVE__UITOA
  764. return _uitoa(value, string, radix);
  765. #else
  766. return SDL_ultoa((unsigned long)value, string, radix);
  767. #endif /* HAVE__UITOA */
  768. }
  769. char *
  770. SDL_ltoa(long value, char *string, int radix)
  771. {
  772. #if defined(HAVE__LTOA)
  773. return _ltoa(value, string, radix);
  774. #else
  775. char *bufp = string;
  776. if (value < 0) {
  777. *bufp++ = '-';
  778. SDL_ultoa(-value, bufp, radix);
  779. } else {
  780. SDL_ultoa(value, bufp, radix);
  781. }
  782. return string;
  783. #endif /* HAVE__LTOA */
  784. }
  785. char *
  786. SDL_ultoa(unsigned long value, char *string, int radix)
  787. {
  788. #if defined(HAVE__ULTOA)
  789. return _ultoa(value, string, radix);
  790. #else
  791. char *bufp = string;
  792. if (value) {
  793. while (value > 0) {
  794. *bufp++ = ntoa_table[value % radix];
  795. value /= radix;
  796. }
  797. } else {
  798. *bufp++ = '0';
  799. }
  800. *bufp = '\0';
  801. /* The numbers went into the string backwards. :) */
  802. SDL_strrev(string);
  803. return string;
  804. #endif /* HAVE__ULTOA */
  805. }
  806. char *
  807. SDL_lltoa(Sint64 value, char *string, int radix)
  808. {
  809. #if defined(HAVE__I64TOA)
  810. return _i64toa(value, string, radix);
  811. #else
  812. char *bufp = string;
  813. if (value < 0) {
  814. *bufp++ = '-';
  815. SDL_ulltoa(-value, bufp, radix);
  816. } else {
  817. SDL_ulltoa(value, bufp, radix);
  818. }
  819. return string;
  820. #endif /* HAVE__I64TOA */
  821. }
  822. char *
  823. SDL_ulltoa(Uint64 value, char *string, int radix)
  824. {
  825. #if defined(HAVE__UI64TOA)
  826. return _ui64toa(value, string, radix);
  827. #else
  828. char *bufp = string;
  829. if (value) {
  830. while (value > 0) {
  831. *bufp++ = ntoa_table[value % radix];
  832. value /= radix;
  833. }
  834. } else {
  835. *bufp++ = '0';
  836. }
  837. *bufp = '\0';
  838. /* The numbers went into the string backwards. :) */
  839. SDL_strrev(string);
  840. return string;
  841. #endif /* HAVE__UI64TOA */
  842. }
  843. int SDL_atoi(const char *string)
  844. {
  845. #ifdef HAVE_ATOI
  846. return atoi(string);
  847. #else
  848. return SDL_strtol(string, NULL, 10);
  849. #endif /* HAVE_ATOI */
  850. }
  851. double SDL_atof(const char *string)
  852. {
  853. #ifdef HAVE_ATOF
  854. return atof(string);
  855. #else
  856. return SDL_strtod(string, NULL);
  857. #endif /* HAVE_ATOF */
  858. }
  859. long
  860. SDL_strtol(const char *string, char **endp, int base)
  861. {
  862. #if defined(HAVE_STRTOL)
  863. return strtol(string, endp, base);
  864. #else
  865. size_t len;
  866. long value = 0;
  867. if (!base) {
  868. if ((SDL_strlen(string) > 2) && (SDL_strncmp(string, "0x", 2) == 0)) {
  869. base = 16;
  870. } else {
  871. base = 10;
  872. }
  873. }
  874. len = SDL_ScanLong(string, base, &value);
  875. if (endp) {
  876. *endp = (char *) string + len;
  877. }
  878. return value;
  879. #endif /* HAVE_STRTOL */
  880. }
  881. unsigned long
  882. SDL_strtoul(const char *string, char **endp, int base)
  883. {
  884. #if defined(HAVE_STRTOUL)
  885. return strtoul(string, endp, base);
  886. #else
  887. size_t len;
  888. unsigned long value = 0;
  889. if (!base) {
  890. if ((SDL_strlen(string) > 2) && (SDL_strncmp(string, "0x", 2) == 0)) {
  891. base = 16;
  892. } else {
  893. base = 10;
  894. }
  895. }
  896. len = SDL_ScanUnsignedLong(string, base, &value);
  897. if (endp) {
  898. *endp = (char *) string + len;
  899. }
  900. return value;
  901. #endif /* HAVE_STRTOUL */
  902. }
  903. Sint64
  904. SDL_strtoll(const char *string, char **endp, int base)
  905. {
  906. #if defined(HAVE_STRTOLL)
  907. return strtoll(string, endp, base);
  908. #else
  909. size_t len;
  910. Sint64 value = 0;
  911. if (!base) {
  912. if ((SDL_strlen(string) > 2) && (SDL_strncmp(string, "0x", 2) == 0)) {
  913. base = 16;
  914. } else {
  915. base = 10;
  916. }
  917. }
  918. len = SDL_ScanLongLong(string, base, &value);
  919. if (endp) {
  920. *endp = (char *) string + len;
  921. }
  922. return value;
  923. #endif /* HAVE_STRTOLL */
  924. }
  925. Uint64
  926. SDL_strtoull(const char *string, char **endp, int base)
  927. {
  928. #if defined(HAVE_STRTOULL)
  929. return strtoull(string, endp, base);
  930. #else
  931. size_t len;
  932. Uint64 value = 0;
  933. if (!base) {
  934. if ((SDL_strlen(string) > 2) && (SDL_strncmp(string, "0x", 2) == 0)) {
  935. base = 16;
  936. } else {
  937. base = 10;
  938. }
  939. }
  940. len = SDL_ScanUnsignedLongLong(string, base, &value);
  941. if (endp) {
  942. *endp = (char *) string + len;
  943. }
  944. return value;
  945. #endif /* HAVE_STRTOULL */
  946. }
  947. double
  948. SDL_strtod(const char *string, char **endp)
  949. {
  950. #if defined(HAVE_STRTOD)
  951. return strtod(string, endp);
  952. #else
  953. size_t len;
  954. double value = 0.0;
  955. len = SDL_ScanFloat(string, &value);
  956. if (endp) {
  957. *endp = (char *) string + len;
  958. }
  959. return value;
  960. #endif /* HAVE_STRTOD */
  961. }
  962. int
  963. SDL_strcmp(const char *str1, const char *str2)
  964. {
  965. #if defined(HAVE_STRCMP)
  966. return strcmp(str1, str2);
  967. #else
  968. int result;
  969. while(1) {
  970. result = (int)((unsigned char) *str1 - (unsigned char) *str2);
  971. if (result != 0 || (*str1 == '\0'/* && *str2 == '\0'*/))
  972. break;
  973. ++str1;
  974. ++str2;
  975. }
  976. return result;
  977. #endif /* HAVE_STRCMP */
  978. }
  979. int
  980. SDL_strncmp(const char *str1, const char *str2, size_t maxlen)
  981. {
  982. #if defined(HAVE_STRNCMP)
  983. return strncmp(str1, str2, maxlen);
  984. #else
  985. int result;
  986. while (maxlen) {
  987. result = (int) (unsigned char) *str1 - (unsigned char) *str2;
  988. if (result != 0 || *str1 == '\0'/* && *str2 == '\0'*/)
  989. break;
  990. ++str1;
  991. ++str2;
  992. --maxlen;
  993. }
  994. if (!maxlen) {
  995. result = 0;
  996. }
  997. return result;
  998. #endif /* HAVE_STRNCMP */
  999. }
  1000. int
  1001. SDL_strcasecmp(const char *str1, const char *str2)
  1002. {
  1003. #ifdef HAVE_STRCASECMP
  1004. return strcasecmp(str1, str2);
  1005. #elif defined(HAVE__STRICMP)
  1006. return _stricmp(str1, str2);
  1007. #else
  1008. int a, b, result;
  1009. while (1) {
  1010. a = SDL_toupper((unsigned char) *str1);
  1011. b = SDL_toupper((unsigned char) *str2);
  1012. result = a - b;
  1013. if (result != 0 || a == 0 /*&& b == 0*/)
  1014. break;
  1015. ++str1;
  1016. ++str2;
  1017. }
  1018. return result;
  1019. #endif /* HAVE_STRCASECMP */
  1020. }
  1021. int
  1022. SDL_strncasecmp(const char *str1, const char *str2, size_t maxlen)
  1023. {
  1024. #ifdef HAVE_STRNCASECMP
  1025. return strncasecmp(str1, str2, maxlen);
  1026. #elif defined(HAVE__STRNICMP)
  1027. return _strnicmp(str1, str2, maxlen);
  1028. #else
  1029. int a, b, result;
  1030. while (maxlen) {
  1031. a = SDL_tolower((unsigned char) *str1);
  1032. b = SDL_tolower((unsigned char) *str2);
  1033. result = a - b;
  1034. if (result != 0 || a == 0 /*&& b == 0*/)
  1035. break;
  1036. ++str1;
  1037. ++str2;
  1038. --maxlen;
  1039. }
  1040. if (maxlen == 0)
  1041. result = 0;
  1042. return result;
  1043. #endif /* HAVE_STRNCASECMP */
  1044. }
  1045. int
  1046. SDL_sscanf(const char *text, SDL_SCANF_FORMAT_STRING const char *fmt, ...)
  1047. {
  1048. int rc;
  1049. va_list ap;
  1050. va_start(ap, fmt);
  1051. rc = SDL_vsscanf(text, fmt, ap);
  1052. va_end(ap);
  1053. return rc;
  1054. }
  1055. #ifdef HAVE_VSSCANF
  1056. int
  1057. SDL_vsscanf(const char *text, const char *fmt, va_list ap)
  1058. {
  1059. return vsscanf(text, fmt, ap);
  1060. }
  1061. #else
  1062. int
  1063. SDL_vsscanf(const char *text, const char *fmt, va_list ap)
  1064. {
  1065. int retval = 0;
  1066. if (!text || !*text) {
  1067. return -1;
  1068. }
  1069. while (*fmt) {
  1070. if (*fmt == ' ') {
  1071. while (SDL_isspace((unsigned char) *text)) {
  1072. ++text;
  1073. }
  1074. ++fmt;
  1075. continue;
  1076. }
  1077. if (*fmt == '%') {
  1078. SDL_bool done = SDL_FALSE;
  1079. long count = 0;
  1080. int radix = 10;
  1081. enum
  1082. {
  1083. DO_SHORT,
  1084. DO_INT,
  1085. DO_LONG,
  1086. DO_LONGLONG
  1087. } inttype = DO_INT;
  1088. size_t advance;
  1089. SDL_bool suppress = SDL_FALSE;
  1090. ++fmt;
  1091. if (*fmt == '%') {
  1092. if (*text == '%') {
  1093. ++text;
  1094. ++fmt;
  1095. continue;
  1096. }
  1097. break;
  1098. }
  1099. if (*fmt == '*') {
  1100. suppress = SDL_TRUE;
  1101. ++fmt;
  1102. }
  1103. fmt += SDL_ScanLong(fmt, 10, &count);
  1104. if (*fmt == 'c') {
  1105. if (!count) {
  1106. count = 1;
  1107. }
  1108. if (suppress) {
  1109. while (count--) {
  1110. ++text;
  1111. }
  1112. } else {
  1113. char *valuep = va_arg(ap, char *);
  1114. while (count--) {
  1115. *valuep++ = *text++;
  1116. }
  1117. ++retval;
  1118. }
  1119. continue;
  1120. }
  1121. while (SDL_isspace((unsigned char) *text)) {
  1122. ++text;
  1123. }
  1124. /* FIXME: implement more of the format specifiers */
  1125. while (!done) {
  1126. switch (*fmt) {
  1127. case '*':
  1128. suppress = SDL_TRUE;
  1129. break;
  1130. case 'h':
  1131. if (inttype > DO_SHORT) {
  1132. ++inttype;
  1133. }
  1134. break;
  1135. case 'l':
  1136. if (inttype < DO_LONGLONG) {
  1137. ++inttype;
  1138. }
  1139. break;
  1140. case 'I':
  1141. if (SDL_strncmp(fmt, "I64", 3) == 0) {
  1142. fmt += 2;
  1143. inttype = DO_LONGLONG;
  1144. }
  1145. break;
  1146. case 'i':
  1147. {
  1148. int index = 0;
  1149. if (text[index] == '-') {
  1150. ++index;
  1151. }
  1152. if (text[index] == '0') {
  1153. if (SDL_tolower((unsigned char) text[index + 1]) == 'x') {
  1154. radix = 16;
  1155. } else {
  1156. radix = 8;
  1157. }
  1158. }
  1159. }
  1160. SDL_FALLTHROUGH;
  1161. case 'd':
  1162. if (inttype == DO_LONGLONG) {
  1163. Sint64 value;
  1164. advance = SDL_ScanLongLong(text, radix, &value);
  1165. text += advance;
  1166. if (advance && !suppress) {
  1167. Sint64 *valuep = va_arg(ap, Sint64 *);
  1168. *valuep = value;
  1169. ++retval;
  1170. }
  1171. } else {
  1172. long value;
  1173. advance = SDL_ScanLong(text, radix, &value);
  1174. text += advance;
  1175. if (advance && !suppress) {
  1176. switch (inttype) {
  1177. case DO_SHORT:
  1178. {
  1179. short *valuep = va_arg(ap, short *);
  1180. *valuep = (short) value;
  1181. }
  1182. break;
  1183. case DO_INT:
  1184. {
  1185. int *valuep = va_arg(ap, int *);
  1186. *valuep = (int) value;
  1187. }
  1188. break;
  1189. case DO_LONG:
  1190. {
  1191. long *valuep = va_arg(ap, long *);
  1192. *valuep = value;
  1193. }
  1194. break;
  1195. case DO_LONGLONG:
  1196. /* Handled above */
  1197. break;
  1198. }
  1199. ++retval;
  1200. }
  1201. }
  1202. done = SDL_TRUE;
  1203. break;
  1204. case 'o':
  1205. if (radix == 10) {
  1206. radix = 8;
  1207. }
  1208. SDL_FALLTHROUGH;
  1209. case 'x':
  1210. case 'X':
  1211. if (radix == 10) {
  1212. radix = 16;
  1213. }
  1214. SDL_FALLTHROUGH;
  1215. case 'u':
  1216. if (inttype == DO_LONGLONG) {
  1217. Uint64 value = 0;
  1218. advance = SDL_ScanUnsignedLongLong(text, radix, &value);
  1219. text += advance;
  1220. if (advance && !suppress) {
  1221. Uint64 *valuep = va_arg(ap, Uint64 *);
  1222. *valuep = value;
  1223. ++retval;
  1224. }
  1225. } else {
  1226. unsigned long value = 0;
  1227. advance = SDL_ScanUnsignedLong(text, radix, &value);
  1228. text += advance;
  1229. if (advance && !suppress) {
  1230. switch (inttype) {
  1231. case DO_SHORT:
  1232. {
  1233. short *valuep = va_arg(ap, short *);
  1234. *valuep = (short) value;
  1235. }
  1236. break;
  1237. case DO_INT:
  1238. {
  1239. int *valuep = va_arg(ap, int *);
  1240. *valuep = (int) value;
  1241. }
  1242. break;
  1243. case DO_LONG:
  1244. {
  1245. long *valuep = va_arg(ap, long *);
  1246. *valuep = value;
  1247. }
  1248. break;
  1249. case DO_LONGLONG:
  1250. /* Handled above */
  1251. break;
  1252. }
  1253. ++retval;
  1254. }
  1255. }
  1256. done = SDL_TRUE;
  1257. break;
  1258. case 'p':
  1259. {
  1260. uintptr_t value = 0;
  1261. advance = SDL_ScanUintPtrT(text, 16, &value);
  1262. text += advance;
  1263. if (advance && !suppress) {
  1264. void **valuep = va_arg(ap, void **);
  1265. *valuep = (void *) value;
  1266. ++retval;
  1267. }
  1268. }
  1269. done = SDL_TRUE;
  1270. break;
  1271. case 'f':
  1272. {
  1273. double value;
  1274. advance = SDL_ScanFloat(text, &value);
  1275. text += advance;
  1276. if (advance && !suppress) {
  1277. float *valuep = va_arg(ap, float *);
  1278. *valuep = (float) value;
  1279. ++retval;
  1280. }
  1281. }
  1282. done = SDL_TRUE;
  1283. break;
  1284. case 's':
  1285. if (suppress) {
  1286. while (!SDL_isspace((unsigned char) *text)) {
  1287. ++text;
  1288. if (count) {
  1289. if (--count == 0) {
  1290. break;
  1291. }
  1292. }
  1293. }
  1294. } else {
  1295. char *valuep = va_arg(ap, char *);
  1296. while (!SDL_isspace((unsigned char) *text)) {
  1297. *valuep++ = *text++;
  1298. if (count) {
  1299. if (--count == 0) {
  1300. break;
  1301. }
  1302. }
  1303. }
  1304. *valuep = '\0';
  1305. ++retval;
  1306. }
  1307. done = SDL_TRUE;
  1308. break;
  1309. default:
  1310. done = SDL_TRUE;
  1311. break;
  1312. }
  1313. ++fmt;
  1314. }
  1315. continue;
  1316. }
  1317. if (*text == *fmt) {
  1318. ++text;
  1319. ++fmt;
  1320. continue;
  1321. }
  1322. /* Text didn't match format specifier */
  1323. break;
  1324. }
  1325. return retval;
  1326. }
  1327. #endif /* HAVE_VSSCANF */
  1328. int
  1329. SDL_snprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, SDL_PRINTF_FORMAT_STRING const char *fmt, ...)
  1330. {
  1331. va_list ap;
  1332. int retval;
  1333. va_start(ap, fmt);
  1334. retval = SDL_vsnprintf(text, maxlen, fmt, ap);
  1335. va_end(ap);
  1336. return retval;
  1337. }
  1338. #if defined(HAVE_LIBC) && defined(__WATCOMC__)
  1339. /* _vsnprintf() doesn't ensure nul termination */
  1340. int SDL_vsnprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, const char *fmt, va_list ap)
  1341. {
  1342. int retval;
  1343. if (!fmt) fmt = "";
  1344. retval = _vsnprintf(text, maxlen, fmt, ap);
  1345. if (maxlen > 0) text[maxlen-1] = '\0';
  1346. if (retval < 0) retval = (int) maxlen;
  1347. return retval;
  1348. }
  1349. #elif defined(HAVE_VSNPRINTF)
  1350. int SDL_vsnprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, const char *fmt, va_list ap)
  1351. {
  1352. if (!fmt) {
  1353. fmt = "";
  1354. }
  1355. return vsnprintf(text, maxlen, fmt, ap);
  1356. }
  1357. #else
  1358. #define TEXT_AND_LEN_ARGS (length < maxlen) ? &text[length] : NULL, (length < maxlen) ? (maxlen - length) : 0
  1359. /* FIXME: implement more of the format specifiers */
  1360. typedef enum
  1361. {
  1362. SDL_CASE_NOCHANGE,
  1363. SDL_CASE_LOWER,
  1364. SDL_CASE_UPPER
  1365. } SDL_letter_case;
  1366. typedef struct
  1367. {
  1368. SDL_bool left_justify; /* for now: ignored. */
  1369. SDL_bool force_sign;
  1370. SDL_bool force_type; /* for now: used only by float printer, ignored otherwise. */
  1371. SDL_bool pad_zeroes;
  1372. SDL_letter_case force_case;
  1373. int width;
  1374. int radix;
  1375. int precision;
  1376. } SDL_FormatInfo;
  1377. static size_t
  1378. SDL_PrintString(char *text, size_t maxlen, SDL_FormatInfo *info, const char *string)
  1379. {
  1380. size_t length = 0;
  1381. size_t slen, sz;
  1382. if (string == NULL) {
  1383. string = "(null)";
  1384. }
  1385. sz = SDL_strlen(string);
  1386. if (info && info->width > 0 && (size_t)info->width > sz) {
  1387. const char fill = info->pad_zeroes ? '0' : ' ';
  1388. size_t width = info->width - sz;
  1389. size_t filllen;
  1390. if (info->precision >= 0 && (size_t)info->precision < sz)
  1391. width += sz - (size_t)info->precision;
  1392. filllen = SDL_min(width, maxlen);
  1393. SDL_memset(text, fill, filllen);
  1394. text += filllen;
  1395. maxlen -= filllen;
  1396. length += width;
  1397. }
  1398. SDL_strlcpy(text, string, maxlen);
  1399. length += sz;
  1400. if (info) {
  1401. if (info->precision >= 0 && (size_t)info->precision < sz) {
  1402. slen = (size_t)info->precision;
  1403. if (slen < maxlen) {
  1404. text[slen] = '\0';
  1405. }
  1406. length -= (sz - slen);
  1407. }
  1408. if (maxlen > 1) {
  1409. if (info->force_case == SDL_CASE_LOWER) {
  1410. SDL_strlwr(text);
  1411. } else if (info->force_case == SDL_CASE_UPPER) {
  1412. SDL_strupr(text);
  1413. }
  1414. }
  1415. }
  1416. return length;
  1417. }
  1418. static void
  1419. SDL_IntPrecisionAdjust(char *num, size_t maxlen, SDL_FormatInfo *info)
  1420. {/* left-pad num with zeroes. */
  1421. size_t sz, pad, have_sign;
  1422. if (!info)
  1423. return;
  1424. have_sign = 0;
  1425. if (*num == '-' || *num == '+') {
  1426. have_sign = 1;
  1427. ++num;
  1428. --maxlen;
  1429. }
  1430. sz = SDL_strlen(num);
  1431. if (info->precision > 0 && sz < (size_t)info->precision) {
  1432. pad = (size_t)info->precision - sz;
  1433. if (pad + sz + 1 <= maxlen) { /* otherwise ignore the precision */
  1434. SDL_memmove(num + pad, num, sz + 1);
  1435. SDL_memset(num, '0', pad);
  1436. }
  1437. }
  1438. info->precision = -1;/* so that SDL_PrintString() doesn't make a mess. */
  1439. if (info->pad_zeroes && info->width > 0 && (size_t)info->width > sz + have_sign) {
  1440. /* handle here: spaces are added before the sign
  1441. but zeroes must be placed _after_ the sign. */
  1442. /* sz hasn't changed: we ignore pad_zeroes if a precision is given. */
  1443. pad = (size_t)info->width - sz - have_sign;
  1444. if (pad + sz + 1 <= maxlen) {
  1445. SDL_memmove(num + pad, num, sz + 1);
  1446. SDL_memset(num, '0', pad);
  1447. }
  1448. info->width = 0; /* so that SDL_PrintString() doesn't make a mess. */
  1449. }
  1450. }
  1451. static size_t
  1452. SDL_PrintLong(char *text, size_t maxlen, SDL_FormatInfo *info, long value)
  1453. {
  1454. char num[130], *p = num;
  1455. if (info->force_sign && value >= 0L) {
  1456. *p++ = '+';
  1457. }
  1458. SDL_ltoa(value, p, info ? info->radix : 10);
  1459. SDL_IntPrecisionAdjust(num, sizeof(num), info);
  1460. return SDL_PrintString(text, maxlen, info, num);
  1461. }
  1462. static size_t
  1463. SDL_PrintUnsignedLong(char *text, size_t maxlen, SDL_FormatInfo *info, unsigned long value)
  1464. {
  1465. char num[130];
  1466. SDL_ultoa(value, num, info ? info->radix : 10);
  1467. SDL_IntPrecisionAdjust(num, sizeof(num), info);
  1468. return SDL_PrintString(text, maxlen, info, num);
  1469. }
  1470. static size_t
  1471. SDL_PrintLongLong(char *text, size_t maxlen, SDL_FormatInfo *info, Sint64 value)
  1472. {
  1473. char num[130], *p = num;
  1474. if (info->force_sign && value >= (Sint64)0) {
  1475. *p++ = '+';
  1476. }
  1477. SDL_lltoa(value, p, info ? info->radix : 10);
  1478. SDL_IntPrecisionAdjust(num, sizeof(num), info);
  1479. return SDL_PrintString(text, maxlen, info, num);
  1480. }
  1481. static size_t
  1482. SDL_PrintUnsignedLongLong(char *text, size_t maxlen, SDL_FormatInfo *info, Uint64 value)
  1483. {
  1484. char num[130];
  1485. SDL_ulltoa(value, num, info ? info->radix : 10);
  1486. SDL_IntPrecisionAdjust(num, sizeof(num), info);
  1487. return SDL_PrintString(text, maxlen, info, num);
  1488. }
  1489. static size_t
  1490. SDL_PrintFloat(char *text, size_t maxlen, SDL_FormatInfo *info, double arg)
  1491. {
  1492. size_t length = 0;
  1493. /* This isn't especially accurate, but hey, it's easy. :) */
  1494. unsigned long value;
  1495. if (arg < 0) {
  1496. if (length < maxlen) {
  1497. text[length] = '-';
  1498. }
  1499. ++length;
  1500. arg = -arg;
  1501. } else if (info->force_sign) {
  1502. if (length < maxlen) {
  1503. text[length] = '+';
  1504. }
  1505. ++length;
  1506. }
  1507. value = (unsigned long) arg;
  1508. length += SDL_PrintUnsignedLong(TEXT_AND_LEN_ARGS, NULL, value);
  1509. arg -= value;
  1510. if (info->precision < 0) {
  1511. info->precision = 6;
  1512. }
  1513. if (info->force_type || info->precision > 0) {
  1514. int mult = 10;
  1515. if (length < maxlen) {
  1516. text[length] = '.';
  1517. }
  1518. ++length;
  1519. while (info->precision-- > 0) {
  1520. value = (unsigned long) (arg * mult);
  1521. length += SDL_PrintUnsignedLong(TEXT_AND_LEN_ARGS, NULL, value);
  1522. arg -= (double) value / mult;
  1523. mult *= 10;
  1524. }
  1525. }
  1526. if (info->width > 0 && (size_t)info->width > length) {
  1527. const char fill = info->pad_zeroes ? '0' : ' ';
  1528. size_t width = info->width - length;
  1529. size_t filllen, movelen;
  1530. filllen = SDL_min(width, maxlen);
  1531. movelen = SDL_min(length, (maxlen - filllen));
  1532. SDL_memmove(&text[filllen], text, movelen);
  1533. SDL_memset(text, fill, filllen);
  1534. length += width;
  1535. }
  1536. return length;
  1537. }
  1538. int
  1539. SDL_vsnprintf(SDL_OUT_Z_CAP(maxlen) char *text, size_t maxlen, const char *fmt, va_list ap)
  1540. {
  1541. size_t length = 0;
  1542. if (!text) {
  1543. maxlen = 0;
  1544. }
  1545. if (!fmt) {
  1546. fmt = "";
  1547. }
  1548. while (*fmt) {
  1549. if (*fmt == '%') {
  1550. SDL_bool done = SDL_FALSE;
  1551. SDL_bool check_flag;
  1552. SDL_FormatInfo info;
  1553. enum
  1554. {
  1555. DO_INT,
  1556. DO_LONG,
  1557. DO_LONGLONG
  1558. } inttype = DO_INT;
  1559. SDL_zero(info);
  1560. info.radix = 10;
  1561. info.precision = -1;
  1562. check_flag = SDL_TRUE;
  1563. while (check_flag) {
  1564. ++fmt;
  1565. switch (*fmt) {
  1566. case '-':
  1567. info.left_justify = SDL_TRUE;
  1568. break;
  1569. case '+':
  1570. info.force_sign = SDL_TRUE;
  1571. break;
  1572. case '#':
  1573. info.force_type = SDL_TRUE;
  1574. break;
  1575. case '0':
  1576. info.pad_zeroes = SDL_TRUE;
  1577. break;
  1578. default:
  1579. check_flag = SDL_FALSE;
  1580. break;
  1581. }
  1582. }
  1583. if (*fmt >= '0' && *fmt <= '9') {
  1584. info.width = SDL_strtol(fmt, (char **)&fmt, 0);
  1585. }
  1586. else if (*fmt == '*') {
  1587. ++fmt;
  1588. info.width = va_arg(ap, int);
  1589. }
  1590. if (*fmt == '.') {
  1591. ++fmt;
  1592. if (*fmt >= '0' && *fmt <= '9') {
  1593. info.precision = SDL_strtol(fmt, (char **)&fmt, 0);
  1594. } else if (*fmt == '*') {
  1595. ++fmt;
  1596. info.precision = va_arg(ap, int);
  1597. } else {
  1598. info.precision = 0;
  1599. }
  1600. if (info.precision < 0) {
  1601. info.precision = 0;
  1602. }
  1603. }
  1604. while (!done) {
  1605. switch (*fmt) {
  1606. case '%':
  1607. if (length < maxlen) {
  1608. text[length] = '%';
  1609. }
  1610. ++length;
  1611. done = SDL_TRUE;
  1612. break;
  1613. case 'c':
  1614. /* char is promoted to int when passed through (...) */
  1615. if (length < maxlen) {
  1616. text[length] = (char) va_arg(ap, int);
  1617. }
  1618. ++length;
  1619. done = SDL_TRUE;
  1620. break;
  1621. case 'h':
  1622. /* short is promoted to int when passed through (...) */
  1623. break;
  1624. case 'l':
  1625. if (inttype < DO_LONGLONG) {
  1626. ++inttype;
  1627. }
  1628. break;
  1629. case 'I':
  1630. if (SDL_strncmp(fmt, "I64", 3) == 0) {
  1631. fmt += 2;
  1632. inttype = DO_LONGLONG;
  1633. }
  1634. break;
  1635. case 'i':
  1636. case 'd':
  1637. if (info.precision >= 0) {
  1638. info.pad_zeroes = SDL_FALSE;
  1639. }
  1640. switch (inttype) {
  1641. case DO_INT:
  1642. length += SDL_PrintLong(TEXT_AND_LEN_ARGS, &info,
  1643. (long) va_arg(ap, int));
  1644. break;
  1645. case DO_LONG:
  1646. length += SDL_PrintLong(TEXT_AND_LEN_ARGS, &info,
  1647. va_arg(ap, long));
  1648. break;
  1649. case DO_LONGLONG:
  1650. length += SDL_PrintLongLong(TEXT_AND_LEN_ARGS, &info,
  1651. va_arg(ap, Sint64));
  1652. break;
  1653. }
  1654. done = SDL_TRUE;
  1655. break;
  1656. case 'p':
  1657. case 'x':
  1658. info.force_case = SDL_CASE_LOWER;
  1659. SDL_FALLTHROUGH;
  1660. case 'X':
  1661. if (info.force_case == SDL_CASE_NOCHANGE) {
  1662. info.force_case = SDL_CASE_UPPER;
  1663. }
  1664. if (info.radix == 10) {
  1665. info.radix = 16;
  1666. }
  1667. if (*fmt == 'p') {
  1668. inttype = DO_LONG;
  1669. }
  1670. SDL_FALLTHROUGH;
  1671. case 'o':
  1672. if (info.radix == 10) {
  1673. info.radix = 8;
  1674. }
  1675. SDL_FALLTHROUGH;
  1676. case 'u':
  1677. info.force_sign = SDL_FALSE;
  1678. if (info.precision >= 0) {
  1679. info.pad_zeroes = SDL_FALSE;
  1680. }
  1681. switch (inttype) {
  1682. case DO_INT:
  1683. length += SDL_PrintUnsignedLong(TEXT_AND_LEN_ARGS, &info,
  1684. (unsigned long)
  1685. va_arg(ap, unsigned int));
  1686. break;
  1687. case DO_LONG:
  1688. length += SDL_PrintUnsignedLong(TEXT_AND_LEN_ARGS, &info,
  1689. va_arg(ap, unsigned long));
  1690. break;
  1691. case DO_LONGLONG:
  1692. length += SDL_PrintUnsignedLongLong(TEXT_AND_LEN_ARGS, &info,
  1693. va_arg(ap, Uint64));
  1694. break;
  1695. }
  1696. done = SDL_TRUE;
  1697. break;
  1698. case 'f':
  1699. length += SDL_PrintFloat(TEXT_AND_LEN_ARGS, &info, va_arg(ap, double));
  1700. done = SDL_TRUE;
  1701. break;
  1702. case 'S':
  1703. {
  1704. /* In practice this is used on Windows for WCHAR strings */
  1705. wchar_t *wide_arg = va_arg(ap, wchar_t *);
  1706. if (wide_arg) {
  1707. char *arg = SDL_iconv_string("UTF-8", "UTF-16LE", (char *)(wide_arg), (SDL_wcslen(wide_arg)+1)*sizeof(*wide_arg));
  1708. info.pad_zeroes = SDL_FALSE;
  1709. length += SDL_PrintString(TEXT_AND_LEN_ARGS, &info, arg);
  1710. SDL_free(arg);
  1711. } else {
  1712. info.pad_zeroes = SDL_FALSE;
  1713. length += SDL_PrintString(TEXT_AND_LEN_ARGS, &info, NULL);
  1714. }
  1715. done = SDL_TRUE;
  1716. }
  1717. break;
  1718. case 's':
  1719. info.pad_zeroes = SDL_FALSE;
  1720. length += SDL_PrintString(TEXT_AND_LEN_ARGS, &info, va_arg(ap, char *));
  1721. done = SDL_TRUE;
  1722. break;
  1723. default:
  1724. done = SDL_TRUE;
  1725. break;
  1726. }
  1727. ++fmt;
  1728. }
  1729. } else {
  1730. if (length < maxlen) {
  1731. text[length] = *fmt;
  1732. }
  1733. ++fmt;
  1734. ++length;
  1735. }
  1736. }
  1737. if (length < maxlen) {
  1738. text[length] = '\0';
  1739. } else if (maxlen > 0) {
  1740. text[maxlen - 1] = '\0';
  1741. }
  1742. return (int)length;
  1743. }
  1744. #undef TEXT_AND_LEN_ARGS
  1745. #endif /* HAVE_VSNPRINTF */
  1746. int
  1747. SDL_asprintf(char **strp, SDL_PRINTF_FORMAT_STRING const char *fmt, ...)
  1748. {
  1749. va_list ap;
  1750. int retval;
  1751. va_start(ap, fmt);
  1752. retval = SDL_vasprintf(strp, fmt, ap);
  1753. va_end(ap);
  1754. return retval;
  1755. }
  1756. int
  1757. SDL_vasprintf(char **strp, const char *fmt, va_list ap)
  1758. {
  1759. int retval;
  1760. int size = 100; /* Guess we need no more than 100 bytes */
  1761. char *p, *np;
  1762. va_list aq;
  1763. *strp = NULL;
  1764. p = (char *)SDL_malloc(size);
  1765. if (p == NULL)
  1766. return -1;
  1767. while (1) {
  1768. /* Try to print in the allocated space */
  1769. va_copy(aq, ap);
  1770. retval = SDL_vsnprintf(p, size, fmt, aq);
  1771. va_end(aq);
  1772. /* Check error code */
  1773. if (retval < 0)
  1774. return retval;
  1775. /* If that worked, return the string */
  1776. if (retval < size) {
  1777. *strp = p;
  1778. return retval;
  1779. }
  1780. /* Else try again with more space */
  1781. size = retval + 1; /* Precisely what is needed */
  1782. np = (char *)SDL_realloc(p, size);
  1783. if (np == NULL) {
  1784. SDL_free(p);
  1785. return -1;
  1786. } else {
  1787. p = np;
  1788. }
  1789. }
  1790. }
  1791. /* vi: set ts=4 sw=4 expandtab: */