abies Tue Sep 16 05:55:02 2003 EDT
Modified files:
/phpdoc/en/reference/mssql/functions mssql-field-length.xml
Log:
Add note about max VARCHAR length on Win32
Index: phpdoc/en/reference/mssql/functions/mssql-field-length.xml
diff -u phpdoc/en/reference/mssql/functions/mssql-field-length.xml:1.3
phpdoc/en/reference/mssql/functions/mssql-field-length.xml:1.4
--- phpdoc/en/reference/mssql/functions/mssql-field-length.xml:1.3 Thu Jul 3
08:38:23 2003
+++ phpdoc/en/reference/mssql/functions/mssql-field-length.xml Tue Sep 16 05:55:02
2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/mssql.xml, last change in rev 1.3 -->
<refentry id="function.mssql-field-length">
<refnamediv>
@@ -13,9 +13,19 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>offset</parameter></methodparam>
</methodsynopsis>
-
- &warn.undocumented.func;
-
+ <para>
+ This function returns the length of field no. <parameter>offset</parameter>
in
+ result <parameter>result</parameter>. If <parameter>offset</parameter> is
omitted,
+ the current field is used.
+ </para>
+ <note>
+ <title>Note to Win32 Users</title>
+ <simpara>
+ Due to a limitation in the underlying API used by PHP (MS DbLib C API),
+ the length of VARCHAR fields is limited to <emphasis>255</emphasis>. If
+ you need to store more data, use a TEXT field instead.
+ </simpara>
+ </note>
</refsect1>
</refentry>
