php创建记录集,生成查询记录集 - [ CI用户指南2.1.0 ] - 在线原生手册 - php中文网...

生成查询记录集

支持使用以下方法生成记录集

result()

该方法执行成功返回一个对象数组，失败则返回一个空数组。

一般情况下，我们使用下面的方法遍历结果，代码就像这样：

$query = $this->db->query("要执行的 SQL");

foreach ($query->result() as $row)

{

echo $row->title;

echo $row->name;

echo $row->body;

}

本函数的别名是 result_object()。

如果当前所执行的 SQL 可能不会返回记录集，我们可以使用如下方法进行判断：

$query = $this->db->query("要执行的 SQL");

if ($query->num_rows() > 0)

{

foreach ($query->result() as $row)

{

echo $row->title;

echo $row->name;

echo $row->body;

}

}

You can also pass a string to result() which represents a class to instantiate for each result object (note: this class must be loaded)

$query = $this->db->query("SELECT * FROM users;");

foreach ($query->result('User') as $row)

{

echo $row->name; // call attributes

echo $row->reverse_name(); // or methods defined on the 'User' class

}

result_array()

该方法执行成功时将记录集作为关联数组返回。失败时返回空数组。一般情况下，我们使用下面的方法遍历结果，代码就像这样：

$query = $this->db->query("要执行的 SQL");

foreach ($query->result_array() as $row)

{

echo $row['title'];

echo $row['name'];

echo $row['body'];

}

row()

该函数将当前请求的第一行数据作为 object 返回。这里是示例代码：

$query = $this->db->query("要执行的 SQL");

if ($query->num_rows() > 0)

{

$row = $query->row();

echo $row->title;

echo $row->name;

echo $row->body;

}

你可以传递参数(参数是行的索引)以便获得某一行的数据。比如我们要获得第 5 行的数据：

$row = $query->row(4);

如果传入的参数超出行索引，则返回第一行(索引为0)数据

You can also add a second String parameter, which is the name of a class to instantiate the row with:

$query = $this->db->query("SELECT * FROM users LIMIT 1;");

$query->row(0, 'User')

echo $row->name; // call attributes

echo $row->reverse_name(); // or methods defined on the 'User' class

row_array()

功能与 row() 一样, 区别在于该函数返回的是一个数组：

$query = $this->db->query("要执行的 SQL");

if ($query->num_rows() > 0)

{

$row = $query->row_array();

echo $row['title'];

echo $row['name'];

echo $row['body'];

}

你可以传递参数(参数是行的索引)以便获得某一行的数据。比如我们要获得第 5 行的数据：

$row = $query->row_array(4);

如果传入的参数超出行索引，则返回第一行(索引为0)数据

除此以外, 我们还可以使用下面的方法通过游标的方式获取记录：

$row = $query->first_row()

$row = $query->last_row()

$row = $query->next_row()

$row = $query->previous_row()

默认情况下他们将返回一个 object，同时你也可以传递参数 "array" 以便使用 array 的方式获取数据

$row = $query->first_row('array')

$row = $query->last_row('array')

$row = $query->next_row('array')

$row = $query->previous_row('array')

结果集辅助函数

$query->num_rows()

该函数将会返回当前请求的行数。在本例子中, $query 表示当前 SQL 所产生的请求结果对象：

$query = $this->db->query('SELECT * FROM my_table');

echo $query->num_rows();

$query->num_fields()

该函数返回当前请求的字段数(列数)：

$query = $this->db->query('SELECT * FROM my_table');

echo $query->num_fields();

$query->free_result()

该函数将会释放当前查询所占用的内存并删除其关联的资源标识。通常来说，PHP 将会脚本执行结束后自动释放内存。如果当前执行的请求将要花很长时间并且占用比较大的资源时,该函数可以在一定程度上降低资源的消耗：

$query = $this->db->query('SELECT title FROM my_table');

foreach ($query->result() as $row)

{

echo $row->title;

}

$query->free_result(); // $query 将不再可用

$query2 = $this->db->query('SELECT name FROM some_table');

$row = $query2->row();

echo $row->name;

$query2->free_result(); // $query2 将不再可用

翻译贡献者:

Hex, kakera, lishen2, wangjunjie871111

最后修改: 2012-02-05 23:00:43