File: ac_auto_include_headers.html

package info (click to toggle)
autoconf-archive 20060312-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 4,180 kB
  • ctags: 13
  • sloc: sh: 455; makefile: 44
file content (113 lines) | stat: -rw-r--r-- 3,030 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
 <head>
  <title>
   Autoconf Macro: ac_auto_include_headers
  </title>
  <link rel="stylesheet" type="text/css" href="ac-archive.css">
 </head>
 <body>
  <table summary="web navigation" style="width:100%;">
   <tbody>
    <tr>
     <td style="width:50%;" align="center">
      <a href=
      "http://autoconf-archive.cryp.to/ac_auto_include_headers.m4">Download M4
      Source</a>
     </td>
     <td style="width:50%;" align="center">
      <a href="macros-by-category.html">Macro Index Page</a>
     </td>
    </tr>
   </tbody>
  </table>
  <hr>
  <h1>
   ac_auto_include_headers
  </h1>
  <h2>
   Synopsis
  </h2>
  <p class="indent" style="white-space:nowrap;">
   <code>AC_AUTO_INCLUDE_HEADERS (HEADER-FILE, INCLUDE-FILE ...)</code>
  </p>
  <h2>
   Description
  </h2>
  <div class="indent">
   <p>
    Given a HEADER-FILE and a space-separated list of INCLUDE-FILEs,
    AC_AUTO_INCLUDE_HEADERS will append to HEADER-FILE a conditional #include
    for each INCLUDE-FILE. For instance, the following macro call:
   </p>
   <pre>
   AC_AUTO_INCLUDE_HEADERS([config-inc.h], [sys/foobar.h])
</pre>
   <p>
    will append the following text to config-inc.h:
   </p>
   <pre>
   #ifdef HAVE_SYS_FOOBAR_H
   # include &lt;sys/foobar.h&gt;
   #endif
</pre>
   <p>
    AC_AUTO_INCLUDE_HEADERS makes it easy to auto-generate a single header file
    that can then be #include'd by multiple files in a project. Because the
    #ifdef's are appended to HEADER-FILE, it's also convenient to include
    additional text in that file. For instance:
   </p>
   <pre>
   cat &lt;&lt;\CIH_EOF &gt; config-inc.h
   /* This file was generated automatically by configure. */

   #ifndef _CONFIG_INC_H_
   #define _CONFIG_INC_H_

   #include &lt;stdio.h&gt;

   CIH_EOF
   AC_AUTO_INCLUDE_HEADERS([config-inc.h], [arpa/inet.h dlfcn.h errno.h])
   echo "#endif" &gt;&gt; config-inc.h
</pre>
   <p>
    Here's an easy way to get a complete list of header files from config.h:
   </p>
   <pre>
   cat config.h | perl -ane '/ HAVE_\S+_H / &amp;&amp; do {$_=$F[$#F-1]; s/^HAVE_//; s/_H/.h/; s|_|/|g; tr/A-Z/a-z/; print "$_ "}'
</pre>
   <p>
    You can then manually edit the resulting list.
   </p>
  </div>
  <h2>
   Author
  </h2>
  <p class="indent">
   Scott Pakin &lt;pakin@uiuc.edu&gt;
  </p>
  <h2>
   Last Modified
  </h2>
  <p class="indent">
   2002-03-04
  </p>
  <h2>
   M4 Source Code
  </h2>
  <div class="indent">
   <pre class="m4source">
AC_DEFUN([AC_AUTO_INCLUDE_HEADERS],
[touch $1
for ac_auto_include_file in $2; do
  ac_auto_include_have=`echo $ac_auto_include_file | sed 'y%./*abcdefghijklmnopqrstuvwxyz%__PABCDEFGHIJKLMNOPQRSTUVWXYZ%;s%[^_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789]%_%g'`
  echo "#ifdef HAVE_$ac_auto_include_have" &gt;&gt; $1
  echo "# include &lt;$ac_auto_include_file&gt;" &gt;&gt; $1
  echo "#endif" &gt;&gt; $1
  echo "" &gt;&gt; $1
done])
</pre>
  </div>
 </body>
</html>