Debian Codegraph @

www/c3ref/c_any.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>Text Encodings</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: SQLITE_ANY SQLITE_UTF16 SQLITE_UTF16BE SQLITE_UTF16LE SQLITE_UTF16_ALIGNED SQLITE_UTF8 SQLITE_UTF8_ZT -->
119 <div class=nosearch>
120 <a href="../c3ref/intro.html"><h2>SQLite C Interface</h2></a>
121 <h2>Text Encodings</h2>
122 </div>
123 <blockquote><pre>
124 #define SQLITE_UTF8 1 /* IMP: R-37514-35566 */
125 #define SQLITE_UTF16LE 2 /* IMP: R-03371-37637 */
126 #define SQLITE_UTF16BE 3 /* IMP: R-51971-34154 */
127 #define SQLITE_UTF16 4 /* Use native byte order */
128 #define SQLITE_ANY 5 /* Deprecated */
129 #define SQLITE_UTF16_ALIGNED 8 /* sqlite3_create_collation only */
130 #define SQLITE_UTF8_ZT 16 /* Zero-terminated UTF8 */
131 </pre></blockquote>
132 <p>
133 These constants define integer codes that represent the various
134 text encodings supported by SQLite.</p>
135
136 <p><dl>
137 <a name="sqliteutf8"></a>
138 <dt>SQLITE_UTF8</dt><dd>Text is encoding as UTF-8</dd></p>
139
140 <p><a name="sqliteutf16le"></a>
141 <dt>SQLITE_UTF16LE</dt><dd>Text is encoding as UTF-16
142 with each code point being expressed "little endian" - the least significant
143 byte first. This is the usual encoding, for example on Windows.</dd></p>
144
145 <p><a name="sqliteutf16be"></a>
146 <dt>SQLITE_UTF16BE</dt><dd>Text is encoding as UTF-16
147 with each code point being expressed "big endian" - the most significant
148 byte first. This encoding is less common, but is still sometimes seen,
149 specially on older systems.</p>
150
151 <p><a name="sqliteutf16"></a>
152 <dt>SQLITE_UTF16</dt><dd>Text is encoding as UTF-16
153 with each code point being expressed either little endian or as big
154 endian, according to the native endianness of the host computer.</p>
155
156 <p><a name="sqliteany"></a>
157 <dt>SQLITE_ANY</dt><dd>This encoding value may only be used
158 to declare the preferred text for <a href="../appfunc.html">application-defined SQL functions</a>
159 created using <a href="../c3ref/create_function.html">sqlite3_create_function()</a> and similar. If the preferred
160 encoding (the 4th parameter to sqlite3_create_function() - the eTextRep
161 parameter) is SQLITE_ANY, that indicates that the function does not have
162 a preference regarding the text encoding of its parameters and can take
163 any text encoding that the SQLite core find convenient to supply. This
164 option is deprecated. Please do not use it in new applications.</p>
165
166 <p><a name="sqliteutf16aligned"></a>
167 <dt>SQLITE_UTF16_ALIGNED</dt><dd>This encoding
168 value may be used as the 3rd parameter (the eTextRep parameter) to
169 <a href="../c3ref/create_collation.html">sqlite3_create_collation()</a> and similar. This encoding value means
170 that the application-defined collating sequence created expects its
171 input strings to be in UTF16 in native byte order, and that the start
172 of the strings must be aligned to a 2-byte boundary.</p>
173
174 <p><a name="sqliteutf8zt"></a>
175 <dt>SQLITE_UTF8_ZT</dt><dd>This option can only be
176 used to specify the text encoding to strings input to
177 <a href="../c3ref/result_blob.html">sqlite3_result_text64()</a> and <a href="../c3ref/bind_blob.html">sqlite3_bind_text64()</a>.
178 The SQLITE_UTF8_ZT encoding means that the input string (call it "z")
179 is UTF-8 encoded and that it is zero-terminated. If the length parameter
180 (call it "n") is non-negative, this encoding option means that the caller
181 guarantees that z array contains at least n+1 bytes and that the z&#91;n&#93;
182 byte has a value of zero.
183 This option gives the same output as SQLITE_UTF8, but can be more efficient
184 by avoiding the need to make a copy of the input string, in some cases.
185 However, if z is allocated to hold fewer than n+1 bytes or if the
186 z&#91;n&#93; byte is not zero, undefined behavior may result.
187 </dl>
188 </p><p>See also lists of
189 <a href="../c3ref/objlist.html">Objects</a>,
190 <a href="../c3ref/constlist.html">Constants</a>, and
191 <a href="../c3ref/funclist.html">Functions</a>.</p>
192