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 version number is needed to generate the header
27 # comment of the amalgamation.
29 if {[lsearch $argv --nostatic]>=0} {
34 if {[lsearch $argv --linemacros]>=0} {
39 set in
[open tsrc
/sqlite3.h
]
44 if {$line=="" && [eof $in]} break
46 regexp {#define\s+SQLITE_VERSION\s+"(.*)"} $line all VERSION
50 # Open the output file and write a header comment at the beginning
53 set out
[open sqlite3.c w
]
54 # Force the output to use unix line endings, even on Windows.
55 fconfigure $out -translation lf
56 set today
[clock format [clock seconds
] -format "%Y-%m-%d %H:%M:%S UTC" -gmt 1]
58 {/******************************************************************************
59 ** This
file is an amalgamation of many separate C
source files from SQLite
60 ** version
$VERSION. By combining all the individual C code files into this
61 ** single large
file, the entire code can be compiled as a single translation
62 ** unit. This allows many compilers to do optimizations that would not be
63 ** possible
if the files were compiled separately. Performance improvements
64 ** of
5% or more are commonly seen when SQLite is compiled as a single
67 ** This
file is all you need to compile SQLite. To use SQLite in other
68 ** programs
, you need this
file and the
"sqlite3.h" header
file that defines
69 ** the programming interface to the SQLite library.
(If you do not have
70 ** the
"sqlite3.h" header
file at hand
, you will find a copy embedded within
71 ** the
text of this
file. Search
for "Begin file sqlite3.h" to find the start
72 ** of the embedded sqlite3.h header
file.
) Additional code files may be needed
73 ** if you want a wrapper to interface SQLite with your choice of programming
74 ** language. The code
for the
"sqlite3" command-line shell is also in a
75 ** separate
file. This
file contains only code
for the core SQLite library.
78 #define SQLITE_AMALGAMATION 1}]
81 {#ifndef SQLITE_PRIVATE
82 # define SQLITE_PRIVATE static
89 # These are the header files used by SQLite. The first time any of these
90 # files are seen in a #include statement in the C code, include the complete
91 # text of the file in-line. The file only needs to be included once.
122 set available_hdr
($hdr) 1
124 set available_hdr
(sqliteInt.h
) 0
126 # 78 stars used for comment formatting.
128 {*****************************************************************************}
130 # Insert a comment into the code
132 proc section_comment
{text} {
134 set n
[string length
$text]
135 set nstar
[expr {60 - $n}]
136 set stars
[string range
$s78 0 $nstar]
137 puts $out "/************** $text $stars/"
140 # Read the source file named $filename and write it into the
141 # sqlite3.c output file. If any #include statements are seen,
142 # process them approprately.
144 proc copy_file
{filename} {
145 global seen_hdr available_hdr out addstatic linemacros
147 set tail
[file tail
$filename]
148 section_comment
"Begin file $tail"
149 if {$linemacros} {puts $out "#line 1 \"$filename\""}
150 set in
[open $filename r
]
151 set varpattern
{^
[a-zA-Z
][a-zA-Z_0-9
*]+(sqlite3
[_a-zA-Z0-9
]+)(\[|
;|
=)}
152 set declpattern
{[a-zA-Z
][a-zA-Z_0-9
]+ \**(sqlite3
[_a-zA-Z0-9
]+)\(}
153 if {[file extension
$filename]==".h"} {
154 set declpattern
" *$declpattern"
156 set declpattern ^
$declpattern
160 if {[regexp {^
\s
*#\s*include\s+["<]([^">]+)[">]} $line all hdr]} {
161 if {[info exists available_hdr
($hdr)]} {
162 if {$available_hdr($hdr)} {
163 if {$hdr!="os_common.h" && $hdr!="hwtime.h"} {
164 set available_hdr
($hdr) 0
166 section_comment
"Include $hdr in the middle of $tail"
168 section_comment
"Continuing where we left off in $tail"
169 if {$linemacros} {puts $out "#line [expr {$ln+1}] \"$filename\""}
171 } elseif
{![info exists seen_hdr
($hdr)]} {
175 puts $out "/* $line */"
177 } elseif
{[regexp {^
#ifdef __cplusplus} $line]} {
179 } elseif
{!$linemacros && [regexp {^
#line} $line]} {
180 # Skip #line directives.
181 } elseif
{$addstatic && ![regexp {^
(static|typedef
)} $line]} {
182 regsub {^SQLITE_API
} $line {} line
183 if {[regexp $declpattern $line all funcname
]} {
184 # Add the SQLITE_PRIVATE or SQLITE_API keyword before functions.
185 # so that linkage can be modified at compile-time.
186 if {[regexp {^sqlite3_
} $funcname]} {
187 puts $out "SQLITE_API $line"
189 puts $out "SQLITE_PRIVATE $line"
191 } elseif
{[regexp $varpattern $line all varname
]} {
192 # Add the SQLITE_PRIVATE before variable declarations or
193 # definitions for internal use
194 if {![regexp {^sqlite3_
} $varname]} {
195 regsub {^extern
} $line {} line
196 puts $out "SQLITE_PRIVATE $line"
198 if {[regexp {const char sqlite3_version
\[\];} $line]} {
199 set line
{const char sqlite3_version
[] = SQLITE_VERSION
;}
201 regsub {^SQLITE_EXTERN
} $line {} line
202 puts $out "SQLITE_API $line"
204 } elseif
{[regexp {^
(SQLITE_EXTERN
)?void
\(\*sqlite3IoTrace
\)} $line]} {
205 regsub {^SQLITE_EXTERN
} $line {} line
206 puts $out "SQLITE_PRIVATE $line"
207 } elseif
{[regexp {^void
\(\*sqlite3Os
} $line]} {
208 puts $out "SQLITE_PRIVATE $line"
217 section_comment
"End of $tail"
221 # Process the source files. Process files containing commonly
222 # used subroutines first in order to help the compiler find
223 # inlining opportunities.