Merge pull request #7379 from kenjis/docs-improve-database-results.rst

docs: improve getResult() in database/results.rst

Author: kenjis

user_guide_src/source/database/index.rst

@@ -1,5 +1,5 @@
 ######################
-Working With Databases
+Working with Databases
 ######################
 
 CodeIgniter comes with a full-featured and very fast abstracted database

user_guide_src/source/database/results.rst

@@ -6,7 +6,7 @@ There are several ways to generate query results:
 
 .. contents::
     :local:
-    :depth: 2
+    :depth: 3
 
 *************
 Result Arrays
@@ -16,26 +16,37 @@ getResult()
 ===========
 
 This method returns the query result as an array of **objects**, or
-**an empty array** on failure. Typically you'll use this in a foreach
+**an empty array** on failure.
+
+Getting an Array of stdClass
+----------------------------
+
+Typically you'll use this in a foreach
 loop, like this:
 
 .. literalinclude:: results/001.php
 
-The above method is an alias of ``getResultObject()``.
+The above method is an alias of :php:meth:`CodeIgniter\\Database\\BaseResult::getResultObject()`.
+
+Getting an Array of Array
+-------------------------
 
 You can pass in the string 'array' if you wish to get your results
 as an array of arrays:
 
 .. literalinclude:: results/002.php
 
-The above usage is an alias of ``getResultArray()``.
+The above usage is an alias of `getResultArray()`_.
+
+Getting an Array of Custom Object
+---------------------------------
 
 You can also pass a string to ``getResult()`` which represents a class to
 instantiate for each result object
 
 .. literalinclude:: results/003.php
 
-The above method is an alias of ``getCustomResultObject()``.
+The above method is an alias of `getCustomResultObject()`_.
 
 getResultArray()
 ================
@@ -272,7 +283,7 @@ Class Reference
         Returns the query results as an array of rows, where each
         row is an object of type ``stdClass``.
 
-        Usage: see `Result Arrays`_.
+        Usage: see `Getting an Array of stdClass`_.
 
     .. php:method:: getCustomResultObject($class_name)