jscoverage/trunk/util.h

/*
    util.h - general purpose utility routines
    Copyright (C) 2007, 2008 siliconforks.com

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/

#ifndef UTIL_H_
#define UTIL_H_

#ifndef HAVE_VASPRINTF
#include <stdarg.h>
#endif
#include <stdbool.h>
#include <stdio.h>
#include <stdlib.h>

#include <sys/stat.h>

extern const char * program;

void fatal(const char * format, ...)
  __attribute__((__noreturn__))
  __attribute__((__format__(printf, 1, 2)));

void fatal_command_line(const char * format, ...)
  __attribute__((__noreturn__))
  __attribute__((__format__(printf, 1, 2)));

void fatal_source(const char * source_file, unsigned int line_number, const char * format, ...)
  __attribute__((__noreturn__))
  __attribute__((__format__(printf, 3, 4)));

void version(void)
  __attribute__((__noreturn__));

size_t addst(size_t x, size_t y);

size_t mulst(size_t x, size_t y);

void * xmalloc(size_t size);

#define xnew(type, count) ((type *) xmalloc(mulst((count), sizeof(type))))

void * xrealloc(void * p, size_t size);

char * xstrdup(const char * s);

char * xstrndup(const char * s, size_t size);

int xasprintf(char ** s, const char * template, ...) __attribute__((__format__(printf, 2, 3)));

char * xgetcwd(void);

FILE * xfopen(const char * file, const char * mode);

void xstat(const char * file, struct stat * buf);

void xlstat(const char * file, struct stat * buf);

void xmkdir(const char * directory);

void mkdir_if_necessary(const char * directory);

void mkdirs(const char * path);

bool str_starts_with(const char * string, const char * prefix);

bool str_ends_with(const char * string, const char * suffix);

char * make_path(const char * parent, const char * relative_path);

char * make_canonical_path(const char * relative_path);

char * make_basename(const char * path);

char * make_dirname(const char * path);

int is_same_file(const char * file1, const char * file2);

int contains_file(const char * file1, const char * file2);

void copy_stream(FILE * source, FILE * destination);

void copy_file(const char * source_file, const char * destination_file);

bool directory_is_empty(const char * directory);

struct DirListEntry {
  char * name;
  struct DirListEntry * next;
};

struct DirListEntry * make_recursive_dir_list(const char * directory);

void free_dir_list(struct DirListEntry * list);

#ifndef HAVE_STRNDUP
char * strndup(const char * s, size_t size);
#endif

#ifndef HAVE_VASPRINTF
int vasprintf(char ** s, const char * template, va_list a);
#endif

#ifndef HAVE_ASPRINTF
int asprintf(char ** s, const char * template, ...) __attribute__((__format__(printf, 2, 3)));
#endif

#endif
1	siliconforks	2	/*
2			util.h - general purpose utility routines
3	siliconforks	87	Copyright (C) 2007, 2008 siliconforks.com
4	siliconforks	2
5			This program is free software; you can redistribute it and/or modify
6			it under the terms of the GNU General Public License as published by
7			the Free Software Foundation; either version 2 of the License, or
8			(at your option) any later version.
9
10			This program is distributed in the hope that it will be useful,
11			but WITHOUT ANY WARRANTY; without even the implied warranty of
12			MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13			GNU General Public License for more details.
14
15			You should have received a copy of the GNU General Public License along
16			with this program; if not, write to the Free Software Foundation, Inc.,
17			51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18			*/
19
20			#ifndef UTIL_H_
21			#define UTIL_H_
22
23	siliconforks	99	#ifndef HAVE_VASPRINTF
24			#include <stdarg.h>
25			#endif
26	siliconforks	106	#include <stdbool.h>
27	siliconforks	2	#include <stdio.h>
28			#include <stdlib.h>
29
30			#include <sys/stat.h>
31
32			extern const char * program;
33
34			void fatal(const char * format, ...)
35			__attribute__((__noreturn__))
36			__attribute__((__format__(printf, 1, 2)));
37
38	siliconforks	191	void fatal_command_line(const char * format, ...)
39			__attribute__((__noreturn__))
40			__attribute__((__format__(printf, 1, 2)));
41
42	siliconforks	370	void fatal_source(const char * source_file, unsigned int line_number, const char * format, ...)
43			__attribute__((__noreturn__))
44			__attribute__((__format__(printf, 3, 4)));
45
46	siliconforks	311	void version(void)
47			__attribute__((__noreturn__));
48
49	siliconforks	106	size_t addst(size_t x, size_t y);
50
51			size_t mulst(size_t x, size_t y);
52
53	siliconforks	2	void * xmalloc(size_t size);
54
55	siliconforks	106	#define xnew(type, count) ((type *) xmalloc(mulst((count), sizeof(type))))
56
57	siliconforks	2	void * xrealloc(void * p, size_t size);
58
59			char * xstrdup(const char * s);
60
61	siliconforks	106	char * xstrndup(const char * s, size_t size);
62
63			int xasprintf(char ** s, const char * template, ...) __attribute__((__format__(printf, 2, 3)));
64
65	siliconforks	2	char * xgetcwd(void);
66
67			FILE * xfopen(const char * file, const char * mode);
68
69			void xstat(const char * file, struct stat * buf);
70
71			void xlstat(const char * file, struct stat * buf);
72
73			void xmkdir(const char * directory);
74
75			void mkdir_if_necessary(const char * directory);
76
77			void mkdirs(const char * path);
78
79	siliconforks	106	bool str_starts_with(const char * string, const char * prefix);
80
81			bool str_ends_with(const char * string, const char * suffix);
82
83	siliconforks	2	char * make_path(const char * parent, const char * relative_path);
84
85			char * make_canonical_path(const char * relative_path);
86
87			char * make_basename(const char * path);
88
89			char * make_dirname(const char * path);
90
91			int is_same_file(const char * file1, const char * file2);
92
93			int contains_file(const char * file1, const char * file2);
94
95			void copy_stream(FILE * source, FILE * destination);
96
97			void copy_file(const char * source_file, const char * destination_file);
98
99	siliconforks	106	bool directory_is_empty(const char * directory);
100	siliconforks	2
101			struct DirListEntry {
102			char * name;
103			struct DirListEntry * next;
104			};
105
106			struct DirListEntry * make_recursive_dir_list(const char * directory);
107
108			void free_dir_list(struct DirListEntry * list);
109
110	siliconforks	125	#ifndef HAVE_STRNDUP
111			char * strndup(const char * s, size_t size);
112	siliconforks	106	#endif
113
114	siliconforks	99	#ifndef HAVE_VASPRINTF
115			int vasprintf(char ** s, const char * template, va_list a);
116	siliconforks	2	#endif
117	siliconforks	99
118			#ifndef HAVE_ASPRINTF
119	siliconforks	106	int asprintf(char ** s, const char * template, ...) __attribute__((__format__(printf, 2, 3)));
120	siliconforks	99	#endif
121
122			#endif