1 /**
2  * Standard C library routine test suite
3  */
4 
5 #include <stdio.h>
6 
7 #include "SDL.h"
8 #include "SDL_test.h"
9 
10 
11 /* Test case functions */
12 
13 /**
14  * @brief Call to SDL_strlcpy
15  */
16 #undef SDL_strlcpy
17 int
stdlib_strlcpy(void * arg)18 stdlib_strlcpy(void *arg)
19 {
20   size_t result;
21   char text[1024];
22   const char *expected;
23 
24   result = SDL_strlcpy(text, "foo", sizeof(text));
25   expected = "foo";
26   SDLTest_AssertPass("Call to SDL_strlcpy(\"foo\")");
27   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
28   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), (int) result);
29 
30   result = SDL_strlcpy(text, "foo", 2);
31   expected = "f";
32   SDLTest_AssertPass("Call to SDL_strlcpy(\"foo\") with buffer size 2");
33   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
34   SDLTest_AssertCheck(result == 3, "Check result value, expected: 3, got: %d", (int) result);
35 
36   return TEST_COMPLETED;
37 }
38 
39 /**
40  * @brief Call to SDL_snprintf
41  */
42 #undef SDL_snprintf
43 int
stdlib_snprintf(void * arg)44 stdlib_snprintf(void *arg)
45 {
46   int result;
47   int predicted;
48   char text[1024];
49   const char *expected;
50 
51   result = SDL_snprintf(text, sizeof(text), "%s", "foo");
52   expected = "foo";
53   SDLTest_AssertPass("Call to SDL_snprintf(\"%%s\", \"foo\")");
54   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
55   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
56 
57   result = SDL_snprintf(text, 2, "%s", "foo");
58   expected = "f";
59   SDLTest_AssertPass("Call to SDL_snprintf(\"%%s\", \"foo\") with buffer size 2");
60   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
61   SDLTest_AssertCheck(result == 3, "Check result value, expected: 3, got: %d", result);
62 
63   result = SDL_snprintf(NULL, 0, "%s", "foo");
64   SDLTest_AssertPass("Call to SDL_snprintf(NULL, 0, \"%%s\", \"foo\")");
65   SDLTest_AssertCheck(result == 3, "Check result value, expected: 3, got: %d", result);
66 
67   result = SDL_snprintf(text, 2, "%s\n", "foo");
68   expected = "f";
69   SDLTest_AssertPass("Call to SDL_snprintf(\"%%s\\n\", \"foo\") with buffer size 2");
70   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
71   SDLTest_AssertCheck(result == 4, "Check result value, expected: 4, got: %d", result);
72 
73   result = SDL_snprintf(text, sizeof(text), "%f", 0.0);
74   predicted = SDL_snprintf(NULL, 0, "%f", 0.0);
75   expected = "0.000000";
76   SDLTest_AssertPass("Call to SDL_snprintf(\"%%f\", 0.0)");
77   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
78   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
79   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
80 
81   result = SDL_snprintf(text, sizeof(text), "%f", 1.0);
82   predicted = SDL_snprintf(NULL, 0, "%f", 1.0);
83   expected = "1.000000";
84   SDLTest_AssertPass("Call to SDL_snprintf(\"%%f\", 1.0)");
85   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
86   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
87   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
88 
89   result = SDL_snprintf(text, sizeof(text), "%.f", 1.0);
90   predicted = SDL_snprintf(NULL, 0, "%.f", 1.0);
91   expected = "1";
92   SDLTest_AssertPass("Call to SDL_snprintf(\"%%.f\", 1.0)");
93   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
94   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
95   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
96 
97   result = SDL_snprintf(text, sizeof(text), "%#.f", 1.0);
98   predicted = SDL_snprintf(NULL, 0, "%#.f", 1.0);
99   expected = "1.";
100   SDLTest_AssertPass("Call to SDL_snprintf(\"%%#.f\", 1.0)");
101   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
102   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
103   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
104 
105   result = SDL_snprintf(text, sizeof(text), "%f", 1.0 + 1.0 / 3.0);
106   predicted = SDL_snprintf(NULL, 0, "%f", 1.0 + 1.0 / 3.0);
107   expected = "1.333333";
108   SDLTest_AssertPass("Call to SDL_snprintf(\"%%f\", 1.0 + 1.0 / 3.0)");
109   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
110   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
111   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
112 
113   result = SDL_snprintf(text, sizeof(text), "%+f", 1.0 + 1.0 / 3.0);
114   predicted = SDL_snprintf(NULL, 0, "%+f", 1.0 + 1.0 / 3.0);
115   expected = "+1.333333";
116   SDLTest_AssertPass("Call to SDL_snprintf(\"%%+f\", 1.0 + 1.0 / 3.0)");
117   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
118   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
119   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
120 
121   result = SDL_snprintf(text, sizeof(text), "%.2f", 1.0 + 1.0 / 3.0);
122   predicted = SDL_snprintf(NULL, 0, "%.2f", 1.0 + 1.0 / 3.0);
123   expected = "1.33";
124   SDLTest_AssertPass("Call to SDL_snprintf(\"%%.2f\", 1.0 + 1.0 / 3.0)");
125   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: %s, got: %s", expected, text);
126   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
127   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
128 
129   result = SDL_snprintf(text, sizeof(text), "%6.2f", 1.0 + 1.0 / 3.0);
130   predicted = SDL_snprintf(NULL, 0, "%6.2f", 1.0 + 1.0 / 3.0);
131   expected = "  1.33";
132   SDLTest_AssertPass("Call to SDL_snprintf(\"%%6.2f\", 1.0 + 1.0 / 3.0)");
133   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: '%s', got: '%s'", expected, text);
134   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
135   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
136 
137   result = SDL_snprintf(text, sizeof(text), "%06.2f", 1.0 + 1.0 / 3.0);
138   predicted = SDL_snprintf(NULL, 0, "%06.2f", 1.0 + 1.0 / 3.0);
139   expected = "001.33";
140   SDLTest_AssertPass("Call to SDL_snprintf(\"%%06.2f\", 1.0 + 1.0 / 3.0)");
141   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: '%s', got: '%s'", expected, text);
142   SDLTest_AssertCheck(result == SDL_strlen(text), "Check result value, expected: %d, got: %d", (int) SDL_strlen(text), result);
143   SDLTest_AssertCheck(predicted == result, "Check predicted value, expected: %d, got: %d", result, predicted);
144 
145   result = SDL_snprintf(text, 5, "%06.2f", 1.0 + 1.0 / 3.0);
146   expected = "001.";
147   SDLTest_AssertPass("Call to SDL_snprintf(\"%%06.2f\", 1.0 + 1.0 / 3.0) with buffer size 5");
148   SDLTest_AssertCheck(SDL_strcmp(text, expected) == 0, "Check text, expected: '%s', got: '%s'", expected, text);
149   SDLTest_AssertCheck(result == 6, "Check result value, expected: 6, got: %d", result);
150 
151   return TEST_COMPLETED;
152 }
153 
154 /**
155  * @brief Call to SDL_getenv and SDL_setenv
156  */
157 int
stdlib_getsetenv(void * arg)158 stdlib_getsetenv(void *arg)
159 {
160   const int nameLen = 16;
161   char name[17];
162   int counter;
163   int result;
164   char * value1;
165   char * value2;
166   char * expected;
167   int overwrite;
168   char * text;
169 
170   /* Create a random name. This tests SDL_getenv, since we need to */
171   /* make sure the variable is not set yet (it shouldn't). */
172   do {
173     for(counter = 0; counter < nameLen; counter++) {
174       name[counter] = (char)SDLTest_RandomIntegerInRange(65, 90);
175     }
176     name[nameLen] = '\0';
177 
178     text = SDL_getenv(name);
179     SDLTest_AssertPass("Call to SDL_getenv('%s')", name);
180     if (text != NULL) {
181       SDLTest_Log("Expected: NULL, Got: '%s' (%i)", text, (int) SDL_strlen(text));
182     }
183   } while (text != NULL);
184 
185   /* Create random values to set */
186   value1 = SDLTest_RandomAsciiStringOfSize(10);
187   value2 = SDLTest_RandomAsciiStringOfSize(10);
188 
189   /* Set value 1 without overwrite */
190   overwrite = 0;
191   expected = value1;
192   result = SDL_setenv(name, value1, overwrite);
193   SDLTest_AssertPass("Call to SDL_setenv('%s','%s', %i)", name, value1, overwrite);
194   SDLTest_AssertCheck(result == 0, "Check result, expected: 0, got: %i", result);
195 
196   /* Check value */
197   text = SDL_getenv(name);
198   SDLTest_AssertPass("Call to SDL_getenv('%s')", name);
199   SDLTest_AssertCheck(text != NULL, "Verify returned text is not NULL");
200   if (text != NULL) {
201     SDLTest_AssertCheck(
202       SDL_strcmp(text, expected) == 0,
203       "Verify returned text, expected: %s, got: %s",
204       expected,
205       text);
206   }
207 
208   /* Set value 2 with overwrite */
209   overwrite = 1;
210   expected = value2;
211   result = SDL_setenv(name, value2, overwrite);
212   SDLTest_AssertPass("Call to SDL_setenv('%s','%s', %i)", name, value2, overwrite);
213   SDLTest_AssertCheck(result == 0, "Check result, expected: 0, got: %i", result);
214 
215   /* Check value */
216   text = SDL_getenv(name);
217   SDLTest_AssertPass("Call to SDL_getenv('%s')", name);
218   SDLTest_AssertCheck(text != NULL, "Verify returned text is not NULL");
219   if (text != NULL) {
220     SDLTest_AssertCheck(
221       SDL_strcmp(text, expected) == 0,
222       "Verify returned text, expected: %s, got: %s",
223       expected,
224       text);
225   }
226 
227   /* Set value 1 without overwrite */
228   overwrite = 0;
229   expected = value2;
230   result = SDL_setenv(name, value1, overwrite);
231   SDLTest_AssertPass("Call to SDL_setenv('%s','%s', %i)", name, value1, overwrite);
232   SDLTest_AssertCheck(result == 0, "Check result, expected: 0, got: %i", result);
233 
234   /* Check value */
235   text = SDL_getenv(name);
236   SDLTest_AssertPass("Call to SDL_getenv('%s')", name);
237   SDLTest_AssertCheck(text != NULL, "Verify returned text is not NULL");
238   if (text != NULL) {
239     SDLTest_AssertCheck(
240       SDL_strcmp(text, expected) == 0,
241       "Verify returned text, expected: %s, got: %s",
242       expected,
243       text);
244   }
245 
246   /* Set value 1 without overwrite */
247   overwrite = 1;
248   expected = value1;
249   result = SDL_setenv(name, value1, overwrite);
250   SDLTest_AssertPass("Call to SDL_setenv('%s','%s', %i)", name, value1, overwrite);
251   SDLTest_AssertCheck(result == 0, "Check result, expected: 0, got: %i", result);
252 
253   /* Check value */
254   text = SDL_getenv(name);
255   SDLTest_AssertPass("Call to SDL_getenv('%s')", name);
256   SDLTest_AssertCheck(text != NULL, "Verify returned text is not NULL");
257   if (text != NULL) {
258     SDLTest_AssertCheck(
259       SDL_strcmp(text, expected) == 0,
260       "Verify returned text, expected: %s, got: %s",
261       expected,
262       text);
263   }
264 
265   /* Negative cases */
266   for (overwrite=0; overwrite <= 1; overwrite++) {
267     result = SDL_setenv(NULL, value1, overwrite);
268     SDLTest_AssertPass("Call to SDL_setenv(NULL,'%s', %i)", value1, overwrite);
269     SDLTest_AssertCheck(result == -1, "Check result, expected: -1, got: %i", result);
270     result = SDL_setenv("", value1, overwrite);
271     SDLTest_AssertPass("Call to SDL_setenv('','%s', %i)", value1, overwrite);
272     SDLTest_AssertCheck(result == -1, "Check result, expected: -1, got: %i", result);
273     result = SDL_setenv("=", value1, overwrite);
274     SDLTest_AssertPass("Call to SDL_setenv('=','%s', %i)", value1, overwrite);
275     SDLTest_AssertCheck(result == -1, "Check result, expected: -1, got: %i", result);
276     result = SDL_setenv(name, NULL, overwrite);
277     SDLTest_AssertPass("Call to SDL_setenv('%s', NULL, %i)", name, overwrite);
278     SDLTest_AssertCheck(result == -1, "Check result, expected: -1, got: %i", result);
279   }
280 
281   /* Clean up */
282   SDL_free(value1);
283   SDL_free(value2);
284 
285   return TEST_COMPLETED;
286 }
287 
288 /**
289  * @brief Call to SDL_sscanf
290  */
291 #undef SDL_sscanf
292 int
stdlib_sscanf(void * arg)293 stdlib_sscanf(void *arg)
294 {
295   int output;
296   int result;
297   int expected_output;
298   int expected_result;
299 
300   expected_output = output = 123;
301   expected_result = -1;
302   result = SDL_sscanf("", "%i", &output);
303   SDLTest_AssertPass("Call to SDL_sscanf(\"\", \"%%i\", &output)");
304   SDLTest_AssertCheck(expected_output == output, "Check output, expected: %i, got: %i", expected_output, output);
305   SDLTest_AssertCheck(expected_result == result, "Check return value, expected: %i, got: %i", expected_result, result);
306 
307   expected_output = output = 123;
308   expected_result = 0;
309   result = SDL_sscanf("a", "%i", &output);
310   SDLTest_AssertPass("Call to SDL_sscanf(\"a\", \"%%i\", &output)");
311   SDLTest_AssertCheck(expected_output == output, "Check output, expected: %i, got: %i", expected_output, output);
312   SDLTest_AssertCheck(expected_result == result, "Check return value, expected: %i, got: %i", expected_result, result);
313 
314   output = 123;
315   expected_output = 2;
316   expected_result = 1;
317   result = SDL_sscanf("2", "%i", &output);
318   SDLTest_AssertPass("Call to SDL_sscanf(\"2\", \"%%i\", &output)");
319   SDLTest_AssertCheck(expected_output == output, "Check output, expected: %i, got: %i", expected_output, output);
320   SDLTest_AssertCheck(expected_result == result, "Check return value, expected: %i, got: %i", expected_result, result);
321 
322   return TEST_COMPLETED;
323 }
324 
325 /* ================= Test References ================== */
326 
327 /* Standard C routine test cases */
328 static const SDLTest_TestCaseReference stdlibTest1 =
329         { (SDLTest_TestCaseFp)stdlib_strlcpy, "stdlib_strlcpy", "Call to SDL_strlcpy", TEST_ENABLED };
330 
331 static const SDLTest_TestCaseReference stdlibTest2 =
332         { (SDLTest_TestCaseFp)stdlib_snprintf, "stdlib_snprintf", "Call to SDL_snprintf", TEST_ENABLED };
333 
334 static const SDLTest_TestCaseReference stdlibTest3 =
335         { (SDLTest_TestCaseFp)stdlib_getsetenv, "stdlib_getsetenv", "Call to SDL_getenv and SDL_setenv", TEST_ENABLED };
336 
337 static const SDLTest_TestCaseReference stdlibTest4 =
338         { (SDLTest_TestCaseFp)stdlib_sscanf, "stdlib_sscanf", "Call to SDL_sscanf", TEST_ENABLED };
339 
340 /* Sequence of Standard C routine test cases */
341 static const SDLTest_TestCaseReference *stdlibTests[] =  {
342     &stdlibTest1, &stdlibTest2, &stdlibTest3, &stdlibTest4, NULL
343 };
344 
345 /* Standard C routine test suite (global) */
346 SDLTest_TestSuiteReference stdlibTestSuite = {
347     "Stdlib",
348     NULL,
349     stdlibTests,
350     NULL
351 };
352