discuz x中 fetch_all函数求解释,该怎么处理

discuz x2.5中 fetch_all函数求解释

1. public static function fetch_all($sql, $arg = array(), $keyfield = '', $silent=false) {
   
2. 
   
3. $data = array();
   
4. $query = self::query($sql, $arg, $silent, false);
   
5. while ($row = self::$db->fetch_array($query)) {
   
6. if ($keyfield && isset($row[$keyfield])) {
   
7. $data[$row[$keyfield]] = $row;
   
8. } else {
   
9. $data[] = $row;
   
10. }
    
11. }
    
12. self::$db->free_result($query);
    
13. return $data;
    
14. }

复制代码

请大侠解释下这个函数，最好每句代码与函数参数代表的意思都解释下。谢谢啊！
------解决思路----------------------

1. 
   
2. 
   
3. /*
   
4. *        $sql        要执行的sql语句
   
5. *        $arg        sql中要用到的参数（数组）
   
6. *        $keyfield        返回数组中的键名(若有)
   
7. *        $silent        已以哪种方式查询（默认是mysql_query，还有mysql_unbuffered_query）
   
8. */
   
9. public static function fetch_all($sql, $arg = array(), $keyfield = '', $silent=false) {
   
10. 
    
11. $data = array();
    
12. $query = self::query($sql, $arg, $silent, false);//执行查询
    
13. while ($row = self::$db->fetch_array($query)) {
    
14. //将查询的资源放到$data数组中，若$keyfield有值，则将$keyfield作为$data的key值
    
15. if ($keyfield && isset($row[$keyfield])) {
    
16. $data[$row[$keyfield]] = $row;
    
17. } else {
    
18. $data[] = $row;
    
19. }
    
20. }
    
21. self::$db->free_result($query);//释放资源
    
22. return $data;//二维数组
    
23. }

复制代码

一个例子

1. 
   
2. //查询uid为1的用户的所有信息
   
3. $res=DB::fetch_all("SELECT * FROM %t WHERE uid=%d",array('common_member',1));

复制代码