t/test.h

   1 /*
   2  * Copyright © 2012, 2020, 2022-2023 Nick Bowler
   3  *
   4  * This program is free software: you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation, either version 3 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  16  */
  17
  18 #ifndef CDECL_TEST_H_
  19 #define CDECL_TEST_H_
  20
  21 #include <stddef.h>
  22 #include <stdbool.h>
  23 #include <limits.h>
  24 #include <assert.h>
  25
  26 #ifndef _
  27 #  define _(x) (x)
  28 #endif
  29
  30 #define MIN(a, b) ((a) < (b) ? (a) : (b))
  31
  32 struct cdecl_declspec;
  33 struct option;
  34 struct cdecl;
  35
  36 struct test_rng;
  37
  38 void *malloc_nofail(size_t size);
  39 void *realloc_nofail(void *ptr, size_t size);
  40 void test_print_specifiers(struct cdecl_declspec *spec);
  41 void test_print_decl(struct cdecl *decl);
  42 void test_explain_decl(struct cdecl *decl);
  43
  44 bool strict_strtoul(unsigned long *val, const char *str, int base);
  45
  46 void test_print_version(const char *program);
  47 void test_print_options(const struct option *lopts);
  48
  49 /*
  50  * Allocate a new random number generator with the given seed string (which
  51  * should normally be a command-line argument).  The string is parsed as an
  52  * integer value as if by strtoull with a base of 0.
  53  */
  54 struct test_rng *test_rng_alloc(const char *seed);
  55
  56 /*
  57  * Free the random number generator rng.
  58  */
  59 void test_rng_free(struct test_rng *rng);
  60
  61 /*
  62  * Return a random integer uniformly on the closed interval [0, limit-1]
  63  */
  64 unsigned test_rng_uniform_int(struct test_rng *rng, unsigned limit);
  65
  66 /*
  67  * Return false or true with 50% probablility either way.
  68  */
  69 static inline int test_rng_50_50(struct test_rng *rng)
  70 {
  71         return test_rng_uniform_int(rng, 2) == 0;
  72 }
  73
  74 #endif