瀏覽代碼

[DOCUMENTATION] English:

- manual fixes

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@16564 44c647ce-9c0f-0410-b52a-842ac1e357ba
thomas 16 年之前
父節點
當前提交
82a727c5df

+ 25 - 25
documentation/manual/en/module_specs/Zend_Db_Select.xml

@@ -956,13 +956,13 @@ $select = $db->select()
 
 
             <para>
             <para>
                 In <classname>Zend_Db_Select</classname>, you can specify conditions for restricting
                 In <classname>Zend_Db_Select</classname>, you can specify conditions for restricting
-                groups using the <code>having()</code> method. Its usage is similar to that of the
-                <code>where()</code> method. The first argument is a string containing a SQL
+                groups using the <methodname>having()</methodname> method. Its usage is similar to that of the
+                <methodname>where()</methodname> method. The first argument is a string containing a SQL
                 expression. The optional second argument is a value that is used to replace a
                 expression. The optional second argument is a value that is used to replace a
                 positional parameter placeholder in the SQL expression. Expressions given in
                 positional parameter placeholder in the SQL expression. Expressions given in
-                multiple invocations of the <code>having()</code> method are combined using the
+                multiple invocations of the <methodname>having()</methodname> method are combined using the
                 Boolean <code>AND</code> operator, or the <code>OR</code> operator if you use the
                 Boolean <code>AND</code> operator, or the <code>OR</code> operator if you use the
-                <code>orHaving()</code> method.
+                <methodname>orHaving()</methodname> method.
             </para>
             </para>
 
 
             <example id="zend.db.select.building.having.example">
             <example id="zend.db.select.building.having.example">
@@ -992,9 +992,9 @@ $select = $db->select()
             <note>
             <note>
 
 
                 <para>
                 <para>
-                    No quoting is applied to expressions given to the <code>having()</code> or
-                    <code>orHaving()</code> methods. If you have column names that need to be
-                    quoted, you must use <code>quoteIdentifier()</code> as you form the string for
+                    No quoting is applied to expressions given to the <methodname>having()</methodname> or
+                    <methodname>orHaving()</methodname> methods. If you have column names that need to be
+                    quoted, you must use <methodname>quoteIdentifier()</methodname> as you form the string for
                     the condition.
                     the condition.
                 </para>
                 </para>
 
 
@@ -1017,14 +1017,14 @@ $select = $db->select()
             </para>
             </para>
 
 
             <para>
             <para>
-                In <classname>Zend_Db_Select</classname>, you can use the <code>order()</code>
+                In <classname>Zend_Db_Select</classname>, you can use the <methodname>order()</methodname>
                 method to specify a column or an array of columns by which to sort. Each element of
                 method to specify a column or an array of columns by which to sort. Each element of
                 the array is a string naming a column. Optionally with the <code>ASC</code>
                 the array is a string naming a column. Optionally with the <code>ASC</code>
                 <code>DESC</code> keyword following it, separated by a space.
                 <code>DESC</code> keyword following it, separated by a space.
             </para>
             </para>
 
 
             <para>
             <para>
-                Like in the <code>from()</code> and <code>group()</code> methods, column names are
+                Like in the <methodname>from()</methodname> and <methodname>group()</methodname> methods, column names are
                 quoted as identifiers, unless they contain parentheses or are an object of
                 quoted as identifiers, unless they contain parentheses or are an object of
                 type <classname>Zend_Db_Expr</classname>.
                 type <classname>Zend_Db_Expr</classname>.
             </para>
             </para>
@@ -1069,7 +1069,7 @@ $select = $db->select()
             </para>
             </para>
 
 
             <para>
             <para>
-                In <classname>Zend_Db_Select</classname>, you can use the <code>limit()</code>
+                In <classname>Zend_Db_Select</classname>, you can use the <methodname>limit()</methodname>
                 method to specify the count of rows and the number of rows to skip. The first
                 method to specify the count of rows and the number of rows to skip. The first
                 argument to this method is the desired count of rows. The second argument is the
                 argument to this method is the desired count of rows. The second argument is the
                 number of rows to skip.
                 number of rows to skip.
@@ -1105,12 +1105,12 @@ $select = $db->select()
             </note>
             </note>
 
 
             <para>
             <para>
-                Use the <code>limitPage()</code> method for an alternative way to specify row count
+                Use the <methodname>limitPage()</methodname> method for an alternative way to specify row count
                 and offset. This method allows you to limit the result set to one of a series of
                 and offset. This method allows you to limit the result set to one of a series of
                 fixed-length subsets of rows from the query's total result set. In other words, you
                 fixed-length subsets of rows from the query's total result set. In other words, you
                 specify the length of a "page" of results, and the ordinal number of the single
                 specify the length of a "page" of results, and the ordinal number of the single
                 page of results you want the query to return. The page number is the first argument
                 page of results you want the query to return. The page number is the first argument
-                of the <code>limitPage()</code> method, and the page length is the second argument.
+                of the <methodname>limitPage()</methodname> method, and the page length is the second argument.
                 Both arguments are required; they have no default values.
                 Both arguments are required; they have no default values.
             </para>
             </para>
 
 
@@ -1139,7 +1139,7 @@ $select = $db->select()
             <title>Adding the DISTINCT Query Modifier</title>
             <title>Adding the DISTINCT Query Modifier</title>
 
 
             <para>
             <para>
-                The <code>distinct()</code> method enables you to add the <code>DISTINCT</code>
+                The <methodname>distinct()</methodname> method enables you to add the <code>DISTINCT</code>
                 keyword to your SQL query.
                 keyword to your SQL query.
             </para>
             </para>
 
 
@@ -1166,7 +1166,7 @@ $select = $db->select()
             <title>Adding the FOR UPDATE Query Modifier</title>
             <title>Adding the FOR UPDATE Query Modifier</title>
 
 
             <para>
             <para>
-                The <code>forUpdate()</code> method enables you to add the <code>FOR UPDATE</code>
+                The <methodname>forUpdate()</methodname> method enables you to add the <code>FOR UPDATE</code>
                 modifier to your SQL query.
                 modifier to your SQL query.
             </para>
             </para>
 
 
@@ -1205,13 +1205,13 @@ $select = $db->select()
 
 
             <para>
             <para>
                 You can execute the query represented by the <classname>Zend_Db_Select</classname>
                 You can execute the query represented by the <classname>Zend_Db_Select</classname>
-                object by passing it as the first argument to the <code>query()</code> method of a
+                object by passing it as the first argument to the <methodname>query()</methodname> method of a
                 <classname>Zend_Db_Adapter_Abstract</classname> object. Use the
                 <classname>Zend_Db_Adapter_Abstract</classname> object. Use the
                 <classname>Zend_Db_Select</classname> objects instead of a string query.
                 <classname>Zend_Db_Select</classname> objects instead of a string query.
             </para>
             </para>
 
 
             <para>
             <para>
-                The <code>query()</code> method returns an object of type
+                The <methodname>query()</methodname> method returns an object of type
                 <classname>Zend_Db_Statement</classname> or PDOStatement, depending on the adapter
                 <classname>Zend_Db_Statement</classname> or PDOStatement, depending on the adapter
                 type.
                 type.
             </para>
             </para>
@@ -1237,8 +1237,8 @@ $result = $stmt->fetchAll();
             <title>Executing Select Queries from the Object</title>
             <title>Executing Select Queries from the Object</title>
 
 
             <para>
             <para>
-                As an alternative to using the <code>query()</code> method of the adapter object,
-                you can use the <code>query()</code> method of the
+                As an alternative to using the <methodname>query()</methodname> method of the adapter object,
+                you can use the <methodname>query()</methodname> method of the
                 <classname>Zend_Db_Select</classname> object. Both methods return an object of type
                 <classname>Zend_Db_Select</classname> object. Both methods return an object of type
                 <classname>Zend_Db_Statement</classname> or PDOStatement, depending on the adapter
                 <classname>Zend_Db_Statement</classname> or PDOStatement, depending on the adapter
                 type.
                 type.
@@ -1266,7 +1266,7 @@ $result = $stmt->fetchAll();
 
 
             <para>
             <para>
                 If you need access to a string representation of the SQL query corresponding to the
                 If you need access to a string representation of the SQL query corresponding to the
-                <classname>Zend_Db_Select</classname> object, use the <code>__toString()</code>
+                <classname>Zend_Db_Select</classname> object, use the <methodname>__toString()</methodname>
                 method.
                 method.
             </para>
             </para>
 
 
@@ -1297,7 +1297,7 @@ echo "$sql\n";
 
 
         <para>
         <para>
             This section describes other methods of the <classname>Zend_Db_Select</classname> class
             This section describes other methods of the <classname>Zend_Db_Select</classname> class
-            that are not covered above: <code>getPart()</code> and <code>reset()</code>.
+            that are not covered above: <methodname>getPart()</methodname> and <methodname>reset()</methodname>.
         </para>
         </para>
 
 
         <sect3 id="zend.db.select.other.get-part">
         <sect3 id="zend.db.select.other.get-part">
@@ -1305,7 +1305,7 @@ echo "$sql\n";
             <title>Retrieving Parts of the Select Object</title>
             <title>Retrieving Parts of the Select Object</title>
 
 
             <para>
             <para>
-                The <code>getPart()</code> method returns a representation of one part of your SQL
+                The <methodname>getPart()</methodname> method returns a representation of one part of your SQL
                 query. For example, you can use this method to return the array of expressions for
                 query. For example, you can use this method to return the array of expressions for
                 the <code>WHERE</code> clause, or the array of columns (or column expressions) that
                 the <code>WHERE</code> clause, or the array of columns (or column expressions) that
                 are in the <code>SELECT</code> list, or the values of the count and offset for the
                 are in the <code>SELECT</code> list, or the values of the count and offset for the
@@ -1320,7 +1320,7 @@ echo "$sql\n";
             </para>
             </para>
 
 
             <para>
             <para>
-                The single argument to the <code>getPart()</code> method is a string that
+                The single argument to the <methodname>getPart()</methodname> method is a string that
                 identifies which part of the Select query to return. For example, the string
                 identifies which part of the Select query to return. For example, the string
                 <code>'from'</code> identifies the part of the Select object that stores
                 <code>'from'</code> identifies the part of the Select object that stores
                 information about the tables in the <code>FROM</code> clause, including joined
                 information about the tables in the <code>FROM</code> clause, including joined
@@ -1428,18 +1428,18 @@ print_r( $orderData );
             <title>Resetting Parts of the Select Object</title>
             <title>Resetting Parts of the Select Object</title>
 
 
             <para>
             <para>
-                The <code>reset()</code> method enables you to clear one specified part of the SQL
+                The <methodname>reset()</methodname> method enables you to clear one specified part of the SQL
                 query, or else clear all parts of the SQL query if you omit the argument.
                 query, or else clear all parts of the SQL query if you omit the argument.
             </para>
             </para>
 
 
             <para>
             <para>
                 The single argument is optional. You can specify the part of the query to clear,
                 The single argument is optional. You can specify the part of the query to clear,
-                using the same strings you used in the argument to the <code>getPart()</code>
+                using the same strings you used in the argument to the <methodname>getPart()</methodname>
                 method. The part of the query you specify is reset to a default state.
                 method. The part of the query you specify is reset to a default state.
             </para>
             </para>
 
 
             <para>
             <para>
-                If you omit the parameter, <code>reset()</code> changes all parts of the query to
+                If you omit the parameter, <methodname>reset()</methodname> changes all parts of the query to
                 their default state. This makes the <classname>Zend_Db_Select</classname> object
                 their default state. This makes the <classname>Zend_Db_Select</classname> object
                 equivalent to a new object, as though you had just instantiated it.
                 equivalent to a new object, as though you had just instantiated it.
             </para>
             </para>

+ 19 - 19
documentation/manual/en/module_specs/Zend_Db_Statement.xml

@@ -5,8 +5,8 @@
     <title>Zend_Db_Statement</title>
     <title>Zend_Db_Statement</title>
 
 
     <para>
     <para>
-        In addition to convenient methods such as <code>fetchAll()</code> and
-        <code>insert()</code> documented in <xref linkend="zend.db.adapter" />,
+        In addition to convenient methods such as <methodname>fetchAll()</methodname> and
+        <methodname>insert()</methodname> documented in <xref linkend="zend.db.adapter" />,
         you can use a statement object to gain more options for running
         you can use a statement object to gain more options for running
         queries and fetching result sets. This section describes how to get an
         queries and fetching result sets. This section describes how to get an
         instance of a statement object, and how to use its methods.
         instance of a statement object, and how to use its methods.
@@ -23,7 +23,7 @@
 
 
         <para>
         <para>
             Typically, a statement object is returned by the
             Typically, a statement object is returned by the
-            <code>query()</code> method of the database Adapter class.
+            <methodname>query()</methodname> method of the database Adapter class.
             This method is a general way to prepare any SQL statement.
             This method is a general way to prepare any SQL statement.
             The first argument is a string containing an SQL statement.
             The first argument is a string containing an SQL statement.
             The optional second argument is an array of values to bind
             The optional second argument is an array of values to bind
@@ -74,7 +74,7 @@ $stmt = new Zend_Db_Statement_Mysqli($db, $sql);
         <para>
         <para>
             You need to execute a statement object if you create it using its
             You need to execute a statement object if you create it using its
             constructor, or if you want to execute the same statement multiple
             constructor, or if you want to execute the same statement multiple
-            times. Use the <code>execute()</code> method of the statement
+            times. Use the <methodname>execute()</methodname> method of the statement
             object. The single argument is an array of value to bind to
             object. The single argument is an array of value to bind to
             parameter placeholders in the statement.
             parameter placeholders in the statement.
         </para>
         </para>
@@ -144,7 +144,7 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
 
 
             <para>
             <para>
                 To retrieve one row from the result set, use the
                 To retrieve one row from the result set, use the
-                <code>fetch()</code> method of the statement object.
+                <methodname>fetch()</methodname> method of the statement object.
                 All three arguments of this method are optional:
                 All three arguments of this method are optional:
             </para>
             </para>
 
 
@@ -164,7 +164,7 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
                         <emphasis>Cursor orientation</emphasis>
                         <emphasis>Cursor orientation</emphasis>
                         is the second argument. The default is
                         is the second argument. The default is
                         Zend_Db::FETCH_ORI_NEXT, which simply means that each
                         Zend_Db::FETCH_ORI_NEXT, which simply means that each
-                        call to <code>fetch()</code> returns the next row in
+                        call to <methodname>fetch()</methodname> returns the next row in
                         the result set, in the order returned by the RDBMS.
                         the result set, in the order returned by the RDBMS.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
@@ -177,13 +177,13 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
                         to return.
                         to return.
                         If the cursor orientation is Zend_Db::FETCH_ORI_REL,
                         If the cursor orientation is Zend_Db::FETCH_ORI_REL,
                         then the offset number is relative to the cursor
                         then the offset number is relative to the cursor
-                        position before <code>fetch()</code> was called.
+                        position before <methodname>fetch()</methodname> was called.
                     </para>
                     </para>
                 </listitem>
                 </listitem>
             </itemizedlist>
             </itemizedlist>
 
 
             <para>
             <para>
-                <code>fetch()</code> returns <constant>FALSE</constant> if all rows of
+                <methodname>fetch()</methodname> returns <constant>FALSE</constant> if all rows of
                 the result set have been fetched.
                 the result set have been fetched.
             </para>
             </para>
 
 
@@ -211,9 +211,9 @@ while ($row = $stmt->fetch()) {
 
 
             <para>
             <para>
                 To retrieve all the rows of the result set in one step, use the
                 To retrieve all the rows of the result set in one step, use the
-                <code>fetchAll()</code> method. This is equivalent to calling
-                the <code>fetch()</code> method in a loop and returning all
-                the rows in an array. The <code>fetchAll()</code> method accepts
+                <methodname>fetchAll()</methodname> method. This is equivalent to calling
+                the <methodname>fetch()</methodname> method in a loop and returning all
+                the rows in an array. The <methodname>fetchAll()</methodname> method accepts
                 two arguments. The first is the fetch style, as described above,
                 two arguments. The first is the fetch style, as described above,
                 and the second indicates the number of the column to return,
                 and the second indicates the number of the column to return,
                 when the fetch style is Zend_Db::FETCH_COLUMN.
                 when the fetch style is Zend_Db::FETCH_COLUMN.
@@ -246,14 +246,14 @@ echo $rows[0]['bug_description'];
                 as associative arrays, mapping column names to column values.
                 as associative arrays, mapping column names to column values.
                 You can specify a different format for the statement class to
                 You can specify a different format for the statement class to
                 return rows, just as you can in the Adapter class. You can use
                 return rows, just as you can in the Adapter class. You can use
-                the <code>setFetchMode()</code> method of the statement object
+                the <methodname>setFetchMode()</methodname> method of the statement object
                 to specify the fetch mode. Specify the fetch mode using
                 to specify the fetch mode. Specify the fetch mode using
                 Zend_Db class constants FETCH_ASSOC, FETCH_NUM, FETCH_BOTH,
                 Zend_Db class constants FETCH_ASSOC, FETCH_NUM, FETCH_BOTH,
                 FETCH_COLUMN, and FETCH_OBJ.
                 FETCH_COLUMN, and FETCH_OBJ.
                 See <xref linkend="zend.db.adapter.select.fetch-mode" />
                 See <xref linkend="zend.db.adapter.select.fetch-mode" />
                 for more information on these modes.
                 for more information on these modes.
-                Subsequent calls to the statement methods <code>fetch()</code>
-                or <code>fetchAll()</code> use the fetch mode that you specify.
+                Subsequent calls to the statement methods <methodname>fetch()</methodname>
+                or <methodname>fetchAll()</methodname> use the fetch mode that you specify.
             </para>
             </para>
 
 
             <example id="zend.db.statement.fetching.fetch-mode.example">
             <example id="zend.db.statement.fetching.fetch-mode.example">
@@ -282,7 +282,7 @@ echo $rows[0][0];
 
 
             <para>
             <para>
                 To return a single column from the next row of the result set,
                 To return a single column from the next row of the result set,
-                use <code>fetchColumn()</code>. The optional argument is the
+                use <methodname>fetchColumn()</methodname>. The optional argument is the
                 integer index of the column, and it defaults to 0. This method
                 integer index of the column, and it defaults to 0. This method
                 returns a scalar value, or <constant>FALSE</constant> if all rows of
                 returns a scalar value, or <constant>FALSE</constant> if all rows of
                 the result set have been fetched.
                 the result set have been fetched.
@@ -290,10 +290,10 @@ echo $rows[0][0];
 
 
             <para>
             <para>
                 Note this method operates differently than the
                 Note this method operates differently than the
-                <code>fetchCol()</code> method of the Adapter class.
-                The <code>fetchColumn()</code> method of a statement returns a
+                <methodname>fetchCol()</methodname> method of the Adapter class.
+                The <methodname>fetchColumn()</methodname> method of a statement returns a
                 single value from one row.
                 single value from one row.
-                The <code>fetchCol()</code> method of an adapter returns an
+                The <methodname>fetchCol()</methodname> method of an adapter returns an
                 array of values, taken from the first column of all rows of the
                 array of values, taken from the first column of all rows of the
                 result set.
                 result set.
             </para>
             </para>
@@ -320,7 +320,7 @@ $bug_status = $stmt->fetchColumn(2);
 
 
             <para>
             <para>
                 To retrieve a row from the result set structured as an object,
                 To retrieve a row from the result set structured as an object,
-                use the <code>fetchObject()</code>. This method takes two
+                use the <methodname>fetchObject()</methodname>. This method takes two
                 optional arguments. The first argument is a string that names
                 optional arguments. The first argument is a string that names
                 the class name of the object to return; the default is
                 the class name of the object to return; the default is
                 'stdClass'. The second argument is an array of values that
                 'stdClass'. The second argument is an array of values that