Debian Codegraph @

www/c3ref/config.html

raw
1 <!DOCTYPE html>
2 <html><head>
3 <meta name="viewport" content="width=device-width, initial-scale=1.0">
4 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
5 <link href="../sqlite.css" rel="stylesheet">
6 <title>Configuring The SQLite Library</title>
7 <!-- path=../ -->
8 </head>
9 <body>
10 <div class=nosearch>
11 <a href="../index.html">
12 <img class="logo" src="../images/sqlite370_banner.svg" alt="SQLite" border="0">
13 </a>
14 <div><!-- IE hack to prevent disappearing logo --></div>
15 <div class="tagline desktoponly">
16 Small. Fast. Reliable.<br>Choose any three.
17 </div>
18 <div class="menu mainmenu">
19 <ul>
20 <li><a href="../index.html">Home</a>
21 <li class='mobileonly'><a href="javascript:void(0)" onclick='toggle_div("submenu")'>Menu</a>
22 <li class='wideonly'><a href='../about.html'>About</a>
23 <li class='desktoponly'><a href="../docs.html">Documentation</a>
24 <li class='desktoponly'><a href="../download.html">Download</a>
25 <li class='wideonly'><a href='../copyright.html'>License</a>
26 <li class='desktoponly'><a href="../support.html">Support</a>
27 <li class='desktoponly'><a href="../prosupport.html">Purchase</a>
28 <li class='search' id='search_menubutton'>
29 <a href="javascript:void(0)" onclick='toggle_search()'>Search</a>
30 </ul>
31 </div>
32 <div class="menu submenu" id="submenu">
33 <ul>
34 <li><a href='../about.html'>About</a>
35 <li><a href='../docs.html'>Documentation</a>
36 <li><a href='../download.html'>Download</a>
37 <li><a href='../support.html'>Support</a>
38 <li><a href='../prosupport.html'>Purchase</a>
39 </ul>
40 </div>
41 <div class="searchmenu" id="searchmenu">
42 <form method="GET" action="../search">
43 <select name="s" id="searchtype">
44 <option value="d">Search Documentation</option>
45 <option value="c">Search Changelog</option>
46 </select>
47 <input type="text" name="q" id="searchbox" value="">
48 <input type="submit" value="Go">
49 </form>
50 </div>
51 </div>
52 <script>
53 function toggle_div(nm) {
54 var w = document.getElementById(nm);
55 if( w.style.display=="block" ){
56 w.style.display = "none";
57 }else{
58 w.style.display = "block";
59 }
60 }
61 function toggle_search() {
62 var w = document.getElementById("searchmenu");
63 if( w.style.display=="block" ){
64 w.style.display = "none";
65 } else {
66 w.style.display = "block";
67 setTimeout(function(){
68 document.getElementById("searchbox").focus()
69 }, 30);
70 }
71 }
72 function div_off(nm){document.getElementById(nm).style.display="none";}
73 window.onbeforeunload = function(e){div_off("submenu");}
74 /* Disable the Search feature if we are not operating from CGI, since */
75 /* Search is accomplished using CGI and will not work without it. */
76 if( !location.origin || !location.origin.match || !location.origin.match(/http/) ){
77 document.getElementById("search_menubutton").style.display = "none";
78 }
79 /* Used by the Hide/Show button beside syntax diagrams, to toggle the */
80 function hideorshow(btn,obj){
81 var x = document.getElementById(obj);
82 var b = document.getElementById(btn);
83 if( x.style.display!='none' ){
84 x.style.display = 'none';
85 b.innerHTML='show';
86 }else{
87 x.style.display = '';
88 b.innerHTML='hide';
89 }
90 return false;
91 }
92 var antiRobot = 0;
93 function antiRobotGo(){
94 if( antiRobot!=3 ) return;
95 antiRobot = 7;
96 var j = document.getElementById("mtimelink");
97 if(j && j.hasAttribute("data-href")) j.href=j.getAttribute("data-href");
98 }
99 function antiRobotDefense(){
100 document.body.onmousedown=function(){
101 antiRobot |= 2;
102 antiRobotGo();
103 document.body.onmousedown=null;
104 }
105 document.body.onmousemove=function(){
106 antiRobot |= 2;
107 antiRobotGo();
108 document.body.onmousemove=null;
109 }
110 setTimeout(function(){
111 antiRobot |= 1;
112 antiRobotGo();
113 }, 100)
114 antiRobotGo();
115 }
116 antiRobotDefense();
117 </script>
118 <!-- keywords: sqlite3_config -->
119 <div class=nosearch>
120 <a href="../c3ref/intro.html"><h2>SQLite C Interface</h2></a>
121 <h2>Configuring The SQLite Library</h2>
122 </div>
123 <blockquote><pre>
124 int sqlite3_config(int, ...);
125 </pre></blockquote>
126 <p>
127 The sqlite3_config() interface is used to make global configuration
128 changes to SQLite in order to tune SQLite to the specific needs of
129 the application. The default configuration is recommended for most
130 applications and so this routine is usually not necessary. It is
131 provided to support rare applications with unusual needs.</p>
132
133 <p><b>The sqlite3_config() interface is not threadsafe. The application
134 must ensure that no other SQLite interfaces are invoked by other
135 threads while sqlite3_config() is running.</b></p>
136
137 <p>The first argument to sqlite3_config() is an integer
138 <a href="../c3ref/c_config_covering_index_scan.html">configuration option</a> that determines
139 what property of SQLite is to be configured. Subsequent arguments
140 vary depending on the <a href="../c3ref/c_config_covering_index_scan.html">configuration option</a>
141 in the first argument.</p>
142
143 <p>For most configuration options, the sqlite3_config() interface
144 may only be invoked prior to library initialization using
145 <a href="../c3ref/initialize.html">sqlite3_initialize()</a> or after shutdown by <a href="../c3ref/initialize.html">sqlite3_shutdown()</a>.
146 The exceptional configuration options that may be invoked at any time
147 are called "anytime configuration options".
148 If sqlite3_config() is called after <a href="../c3ref/initialize.html">sqlite3_initialize()</a> and before
149 <a href="../c3ref/initialize.html">sqlite3_shutdown()</a> with a first argument that is not an anytime
150 configuration option, then the sqlite3_config() call will
151 return SQLITE_MISUSE.
152 Note, however, that sqlite3_config() can be called as part of the
153 implementation of an application-defined <a href="../c3ref/initialize.html">sqlite3_os_init()</a>.</p>
154
155 <p>When a configuration option is set, sqlite3_config() returns <a href="../rescode.html#ok">SQLITE_OK</a>.
156 If the option is unknown or SQLite is unable to set the option
157 then this routine returns a non-zero <a href="../rescode.html">error code</a>.
158 </p><p>See also lists of
159 <a href="../c3ref/objlist.html">Objects</a>,
160 <a href="../c3ref/constlist.html">Constants</a>, and
161 <a href="../c3ref/funclist.html">Functions</a>.</p>
162