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 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.
117 set available_hdr
($hdr) 1
119 set available_hdr
(sqliteInt.h
) 0
121 # 78 stars used for comment formatting.
123 {*****************************************************************************}
125 # Insert a comment into the code
127 proc section_comment
{text} {
129 set n
[string length
$text]
130 set nstar
[expr {60 - $n}]
131 set stars
[string range
$s78 0 $nstar]
132 puts $out "/************** $text $stars/"
135 # Read the source file named $filename and write it into the
136 # sqlite3.c output file. If any #include statements are seen,
137 # process them approprately.
139 proc copy_file
{filename} {
140 global seen_hdr available_hdr out addstatic linemacros
142 set tail
[file tail
$filename]
143 section_comment
"Begin file $tail"
144 if {$linemacros} {puts $out "#line 1 \"$filename\""}
145 set in
[open $filename r
]
146 set varpattern
{^
[a-zA-Z
][a-zA-Z_0-9
*]+(sqlite3
[_a-zA-Z0-9
]+)(\[|
;|
=)}
147 set declpattern
{[a-zA-Z
][a-zA-Z_0-9
]+ \**(sqlite3
[_a-zA-Z0-9
]+)\(}
148 if {[file extension
$filename]==".h"} {
149 set declpattern
" *$declpattern"
151 set declpattern ^
$declpattern
155 if {[regexp {^
\s
*#\s*include\s+["<]([^">]+)[">]} $line all hdr]} {
156 if {[info exists available_hdr
($hdr)]} {
157 if {$available_hdr($hdr)} {
158 if {$hdr!="os_common.h" && $hdr!="hwtime.h"} {
159 set available_hdr
($hdr) 0
161 section_comment
"Include $hdr in the middle of $tail"
163 section_comment
"Continuing where we left off in $tail"
164 if {$linemacros} {puts $out "#line [expr {$ln+1}] \"$filename\""}
166 } elseif
{![info exists seen_hdr
($hdr)]} {
170 puts $out "/* $line */"
172 } elseif
{[regexp {^
#ifdef __cplusplus} $line]} {
174 } elseif
{!$linemacros && [regexp {^
#line} $line]} {
175 # Skip #line directives.
176 } elseif
{$addstatic && ![regexp {^
(static|typedef
)} $line]} {
177 regsub {^SQLITE_API
} $line {} line
178 if {[regexp $declpattern $line all funcname
]} {
179 # Add the SQLITE_PRIVATE or SQLITE_API keyword before functions.
180 # so that linkage can be modified at compile-time.
181 if {[regexp {^sqlite3_
} $funcname]} {
182 puts $out "SQLITE_API $line"
184 puts $out "SQLITE_PRIVATE $line"
186 } elseif
{[regexp $varpattern $line all varname
]} {
187 # Add the SQLITE_PRIVATE before variable declarations or
188 # definitions for internal use
189 if {![regexp {^sqlite3_
} $varname]} {
190 regsub {^extern
} $line {} line
191 puts $out "SQLITE_PRIVATE $line"
193 if {[regexp {const char sqlite3_version
\[\];} $line]} {
194 set line
{const char sqlite3_version
[] = SQLITE_VERSION
;}
196 regsub {^SQLITE_EXTERN
} $line {} line
197 puts $out "SQLITE_API $line"
199 } elseif
{[regexp {^
(SQLITE_EXTERN
)?void
\(\*sqlite3IoTrace
\)} $line]} {
200 regsub {^SQLITE_EXTERN
} $line {} line
201 puts $out "SQLITE_PRIVATE $line"
202 } elseif
{[regexp {^void
\(\*sqlite3Os
} $line]} {
203 puts $out "SQLITE_PRIVATE $line"
212 section_comment
"End of $tail"
216 # Process the source files. Process files containing commonly
217 # used subroutines first in order to help the compiler find
218 # inlining opportunities.