1

#ifndef TEST_UTIL_H

     2

#define TEST_UTIL_H

     3

     4

/**

     5

 * @file

     6

 *

     7

 * General utility functions for tests

     8

 */

     9

#include <sys/types.h>

    10

    11

#define DUMP_STR_BUF 1024

    12

#define DUMP_STR_COUNT 8

    13

    14

/**

    15

 * This re-formats the given string to escape values, and returns a pointer to an internal static buffer.

    16

 *

    17

 * If len is given as >= 0, only the given number of chars will be dumped from str.

    18

 *

    19

 * The buffer cycles a bit, so the returned pointers remain valid across DUMP_STR_COUNT calls.

    20

 *

    21

 * The resulting string is truncated to DUMP_STR_BUF bytes, including the ending "...'\0".

    22

 *

    23

 * @param str the string to dump, should be NUL-terminated unless len is given

    24

 * @param len if negative, ignored, otherwise, only this many bytes are dumped from str

    25

 * @param return a pointer to a static buffer that remains valid across DUMP_STR_COUNT calls to this function

    26

 */

    27

const char *dump_strn (const char *str, ssize_t len);

    28

    29

/**

    30

 * As dump_strn(), with str as a NUL-terminated string

    31

 */

    32

const char *dump_str (const char *str); 

    33

    34

#endif