From ceb2059213c30f9e27652281790335ff068791bd Mon Sep 17 00:00:00 2001
From: Moriyoshi Koizumi <moriyoshi@php.net>
Date: Sun, 2 Nov 2003 18:51:44 +0000
Subject: [PATCH] Initial documentation

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@143615 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/iconv/functions/iconv-strlen.xml | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/reference/iconv/functions/iconv-strlen.xml b/reference/iconv/functions/iconv-strlen.xml
index 782dfd13e8..8e2a8cb95a 100644
--- a/reference/iconv/functions/iconv-strlen.xml
+++ b/reference/iconv/functions/iconv-strlen.xml
@@ -1,11 +1,11 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -->
   <refentry id="function.iconv-strlen">
    <refnamediv>
     <refname>iconv_strlen</refname>
     <refpurpose>
-     Returns the character count of str
+     Returns the character count of string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -15,9 +15,20 @@
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam>
     </methodsynopsis>
-
-     &warn.undocumented.func;
-
+    <para>
+      Returns the character count of <parameter>string</parameter>.
+    </para>
+    <para>
+      In contrast to <function>strlen</function>, the return value of
+      <function>iconv_strlen</function> is the number of characters that occur
+      in the given byte sequence <parameter>string</parameter>, which is not
+      necessarily the same as the byte length of the string.
+    </para>
+    <para>
+      If <parameter>charset</parameter> parameter is omitted,
+      <parameter>string</parameter> will be assumed to be encoded in
+      <link linkend="iconv.configuration">iconv.internal_charset</link>.
+    </para>
    </refsect1>
   </refentry>