3 # To build a single huge source file holding all of SQLite (or at
4 # least the core components - the test harness, shell, and TCL
5 # interface are omitted.) first do
9 # The make target above moves all of the source code files into
10 # a subdirectory named "tsrc". (This script expects to find the files
11 # there and will not work if they are not found.) There are a few
12 # generated C code files that are also added to the tsrc directory.
13 # For example, the "parse.c" and "parse.h" files to implement the
14 # the parser are derived from "parse.y" using lemon. And the
15 # "keywordhash.h" files is generated by a program named "mkkeywordhash".
17 # After the "tsrc" directory has been created and populated, run
20 # tclsh mksqlite3c.tcl
22 # The amalgamated SQLite code will be written into sqlite3.c
25 # Begin by reading the "sqlite3.h" header file. Extract the version number
26 # from in this file. The versioon number is needed to generate the header
27 # comment of the amalgamation.
29 if {[lsearch $argv --nostatic]>=0} {
34 set in
[open tsrc
/sqlite3.h
]
39 if {$line=="" && [eof $in]} break
41 regexp {#define\s+SQLITE_VERSION\s+"(.*)"} $line all VERSION
45 # Open the output file and write a header comment at the beginning
48 set out
[open sqlite3.c w
]
49 set today
[clock format [clock seconds
] -format "%Y-%m-%d %H:%M:%S UTC" -gmt 1]
51 {/******************************************************************************
52 ** This
file is an amalgamation of many separate C
source files from SQLite
53 ** version
$VERSION. By combining all the individual C code files into this
54 ** single large
file, the entire code can be compiled as a single translation
55 ** unit. This allows many compilers to do optimizations that would not be
56 ** possible
if the files were compiled separately. Performance improvements
57 ** of
5% or more are commonly seen when SQLite is compiled as a single
60 ** This
file is all you need to compile SQLite. To use SQLite in other
61 ** programs
, you need this
file and the
"sqlite3.h" header
file that defines
62 ** the programming interface to the SQLite library.
(If you do not have
63 ** the
"sqlite3.h" header
file at hand
, you will find a copy embedded within
64 ** the
text of this
file. Search
for "Begin file sqlite3.h" to find the start
65 ** of the embedded sqlite3.h header
file.
) Additional code files may be needed
66 ** if you want a wrapper to interface SQLite with your choice of programming
67 ** language. The code
for the
"sqlite3" command-line shell is also in a
68 ** separate
file. This
file contains only code
for the core SQLite library.
71 #define SQLITE_AMALGAMATION 1}]
74 {#ifndef SQLITE_PRIVATE
75 # define SQLITE_PRIVATE static
82 # These are the header files used by SQLite. The first time any of these
83 # files are seen in a #include statement in the C code, include the complete
84 # text of the file in-line. The file only needs to be included once.
114 set available_hdr
($hdr) 1
116 set available_hdr
(sqliteInt.h
) 0
118 # 78 stars used for comment formatting.
120 {*****************************************************************************}
122 # Insert a comment into the code
124 proc section_comment
{text} {
126 set n
[string length
$text]
127 set nstar
[expr {60 - $n}]
128 set stars
[string range
$s78 0 $nstar]
129 puts $out "/************** $text $stars/"
132 # Read the source file named $filename and write it into the
133 # sqlite3.c output file. If any #include statements are seen,
134 # process them approprately.
136 proc copy_file
{filename} {
137 global seen_hdr available_hdr out addstatic
138 set tail
[file tail
$filename]
139 section_comment
"Begin file $tail"
140 set in
[open $filename r
]
141 set varpattern
{^
[a-zA-Z
][a-zA-Z_0-9
*]+(sqlite3
[_a-zA-Z0-9
]+)(\[|
;|
=)}
142 set declpattern
{[a-zA-Z
][a-zA-Z_0-9
]+ \**(sqlite3
[_a-zA-Z0-9
]+)\(}
143 if {[file extension
$filename]==".h"} {
144 set declpattern
" *$declpattern"
146 set declpattern ^
$declpattern
149 if {[regexp {^
\s
*#\s*include\s+["<]([^">]+)[">]} $line all hdr]} {
150 if {[info exists available_hdr
($hdr)]} {
151 if {$available_hdr($hdr)} {
152 if {$hdr!="os_common.h" && $hdr!="hwtime.h"} {
153 set available_hdr
($hdr) 0
155 section_comment
"Include $hdr in the middle of $tail"
157 section_comment
"Continuing where we left off in $tail"
159 } elseif
{![info exists seen_hdr
($hdr)]} {
163 } elseif
{[regexp {^
#ifdef __cplusplus} $line]} {
165 } elseif
{[regexp {^
#line} $line]} {
166 # Skip #line directives.
167 } elseif
{$addstatic && ![regexp {^
(static|typedef
)} $line]} {
168 regsub {^SQLITE_API
} $line {} line
169 if {[regexp $declpattern $line all funcname
]} {
170 # Add the SQLITE_PRIVATE or SQLITE_API keyword before functions.
171 # so that linkage can be modified at compile-time.
172 if {[regexp {^sqlite3_
} $funcname]} {
173 puts $out "SQLITE_API $line"
175 puts $out "SQLITE_PRIVATE $line"
177 } elseif
{[regexp $varpattern $line all varname
]} {
178 # Add the SQLITE_PRIVATE before variable declarations or
179 # definitions for internal use
180 if {![regexp {^sqlite3_
} $varname]} {
181 regsub {^extern
} $line {} line
182 puts $out "SQLITE_PRIVATE $line"
184 if {[regexp {const char sqlite3_version
\[\];} $line]} {
185 set line
{const char sqlite3_version
[] = SQLITE_VERSION
;}
187 regsub {^SQLITE_EXTERN
} $line {} line
188 puts $out "SQLITE_API $line"
190 } elseif
{[regexp {^
(SQLITE_EXTERN
)?void
\(\*sqlite3IoTrace
\)} $line]} {
191 regsub {^SQLITE_EXTERN
} $line {} line
192 puts $out "SQLITE_PRIVATE $line"
193 } elseif
{[regexp {^void
\(\*sqlite3Os
} $line]} {
194 puts $out "SQLITE_PRIVATE $line"
203 section_comment
"End of $tail"
207 # Process the source files. Process files containing commonly
208 # used subroutines first in order to help the compiler find
209 # inlining opportunities.