Source of: /manual/en/function.sqlite-libencoding.php
<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.sqlite.inc";
$setup = array (
'home' =>
array (
0 => 'index.php',
1 => 'PHP Manual',
),
'head' =>
array (
0 => 'UTF-8',
1 => 'en',
),
'this' =>
array (
0 => 'function.sqlite-libencoding.php',
1 => 'sqlite_libencoding',
),
'up' =>
array (
0 => 'ref.sqlite.php',
1 => 'SQLite Functions',
),
'prev' =>
array (
0 => 'function.sqlite-last-insert-rowid.php',
1 => 'sqlite_last_insert_rowid',
),
'next' =>
array (
0 => 'function.sqlite-libversion.php',
1 => 'sqlite_libversion',
),
);
$setup["toc"] = $TOC;
$setup["parents"] = $PARENTS;
manual_setup($setup);
manual_header();
?>
<div id="function.sqlite-libencoding" class="refentry">
<div class="refnamediv">
<h1 class="refname">sqlite_libencoding</h1>
<p class="verinfo">(PHP 5, PECL sqlite >= 1.0.0)</p><p class="refpurpose"><span class="refname">sqlite_libencoding</span> — <span class="dc-title">Returns the encoding of the linked SQLite library</span></p>
</div>
<a name="function.sqlite-libencoding.description"></a><div class="refsect1 description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">string</span> <span class="methodname"><b>sqlite_libencoding</b></span>
( <span class="methodparam">void</span>
)</div>
<p class="para rdfs-comment">
The SQLite library may be compiled in either <i>ISO-8859-1</i>
or <i>UTF-8</i> compatible modes. This function allows you to
determine which encoding scheme is used by your version of the library.
</p>
<div class="warning"><b class="warning">Warning</b>
<p class="para">
The default PHP distribution builds <var class="filename">libsqlite</var> in
<i>ISO-8859-1</i> encoding
mode. However, this is a misnomer; rather than handling
<i>ISO-8859-1</i>, it operates according to your current
locale settings for string comparisons and sort ordering. So, rather
than <i>ISO-8859-1</i>, you should think of it as being
'<i>8-bit</i>' instead.
</p>
</div>
<p class="para">
When compiled with <i>UTF-8</i> support, sqlite handles encoding and decoding
of <i>UTF-8</i> multi-byte character sequences, but does not yet do a complete
job when working with the data (no normalization is performed for
example), and some comparison operations may still not be carried out
correctly.
</p>
<div class="warning"><b class="warning">Warning</b>
<p class="para">
It is not recommended that you use PHP in a web-server configuration
with a version of the SQLite library compiled with <i>UTF-8</i> support, since
<var class="filename">libsqlite</var> will abort the process if it detects a problem with the
<i>UTF-8</i> encoding.
</p>
</div>
</div>
<a name="function.sqlite-libencoding.returnvalues"></a><div class="refsect1 returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns the library encoding.
</p>
</div>
<a name="function.sqlite-libencoding.seealso"></a><div class="refsect1 seealso">
<h3 class="title">See Also</h3>
<p class="para">
</p><ul class="simplelist">
<li class="member"><b>sqlite_lib_version()</b></li>
</ul><p>
</p>
</div>
</div><?php manual_footer(); ?>
