svn: /phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/ field-count.xml param-count.xml

mumumu                                   Tue, 22 Dec 2020 02:12:25 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=352163

Log:
Doc Bug #72393 mysqli_stmt_field_count undocumented

Bug: https://bugs.php.net/72393 (Verified) mysqli_stmt_field_count undocumented
      
Changed paths:
    U   phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/field-count.xml
    U   phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/param-count.xml

Modified: phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/field-count.xml
===================================================================
--- phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/field-count.xml	2020-12-22 02:05:04 UTC (rev 352162)
+++ phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/field-count.xml	2020-12-22 02:12:25 UTC (rev 352163)
@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 322008 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352160 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
 <refentry xml:id="mysqli-stmt.field-count" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli_stmt::$field_count</refname>
   <refname>mysqli_stmt_field_count</refname>
-  <refpurpose>指定したステートメントのフィールド数を返す</refpurpose>
+  <refpurpose>指定したステートメントのカラム数を返す</refpurpose>
  </refnamediv>

  <refsect1 role="description">
@@ -17,11 +18,89 @@
    <type>int</type><methodname>mysqli_stmt_field_count</methodname>
    <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam>
   </methodsynopsis>
+  <para>
+   プリペアドステートメントで指定されたカラムの数を返します。
+  </para>
+ </refsect1>

-  &warn.undocumented.func;
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    &mysqli.stmt.description;
+   </variablelist>
+  </para>
+ </refsect1>

+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   カラム数を示す整数値を返します。
+  </para>
  </refsect1>

+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>&style.oop;</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
+$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
+
+$code = 'FR';
+
+$stmt = $mysqli->prepare("SELECT Name FROM Country WHERE Code=?");
+$stmt->bind_param('s', $code);
+$stmt->execute();
+$row = $stmt->get_result()->fetch_row();
+for ($i = 0; $i < $stmt->field_count; $i++) {
+    printf("Value of column number %d is %s", $i, $row[$i]);
+}
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>&style.procedural;</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
+$mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");
+
+$code = 'FR';
+
+$stmt = mysqli_prepare($mysqli, "SELECT Name FROM Country WHERE Code=?");
+mysqli_stmt_bind_param($stmt, 's', $code);
+mysqli_stmt_execute($stmt);
+$result = mysqli_stmt_get_result($stmt);
+$row = mysqli_fetch_row($result);
+for ($i = 0; $i < mysqli_stmt_field_count($stmt); $i++) {
+    printf("Value of column number %d is %s", $i, $row[$i]);
+}
+]]>
+   </programlisting>
+   &examples.outputs.similar;
+   <screen>
+<![CDATA[
+Value of column number 0 is France
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>mysqli_stmt_num_rows</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
 </refentry>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/param-count.xml
===================================================================
--- phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/param-count.xml	2020-12-22 02:05:04 UTC (rev 352162)
+++ phpdoc/ja/trunk/reference/mysqli/mysqli_stmt/param-count.xml	2020-12-22 02:12:25 UTC (rev 352163)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 322008 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 352160 Maintainer: takagi Status: ready -->
 <refentry xml:id="mysqli-stmt.param-count" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli_stmt::$param_count</refname>