modules: several small doxygen bug fixes
[sip-router] / modules / db_mysql / km_row.c
1 /* 
2  * $Id$ 
3  *
4  * MySQL module row related functions
5  *
6  * Copyright (C) 2001-2003 FhG Fokus
7  * Copyright (C) 2008 1&1 Internet AG
8  *
9  * This file is part of Kamailio, a free SIP server.
10  *
11  * Kamailio is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation; either version 2 of the License, or
14  * (at your option) any later version
15  *
16  * Kamailio is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License 
22  * along with this program; if not, write to the Free Software 
23  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
24  */
25
26 /*! \file
27  *  \brief DB_MYSQL :: Row related functions
28  *  \ingroup db_mysql
29  *  Module: \ref db_mysql
30  */
31
32 #include "../../dprint.h"
33 #include "../../mem/mem.h"
34 #include "../../lib/srdb1/db_row.h"
35 #include "../../lib/srdb1/db_val.h"
36 #include "km_my_con.h"
37 #include "km_val.h"
38 #include "km_row.h"
39
40 /*!
41  * \brief Convert a row from result into DB API representation
42  * \param _h database connection
43  * \param _res database result in the DB API representation
44  * \param _r database result row
45  * \return 0 on success, -1 on failure
46  */
47 int db_mysql_convert_row(const db1_con_t* _h, db1_res_t* _res, db_row_t* _r)
48 {
49         unsigned long* lengths;
50         int i;
51
52         if ((!_h) || (!_res) || (!_r)) {
53                 LM_ERR("invalid parameter value\n");
54                 return -1;
55         }
56
57         if (db_allocate_row(_res, _r) != 0) {
58                 LM_ERR("could not allocate row");
59                 return -2;
60         }
61         
62         lengths = mysql_fetch_lengths(CON_RESULT(_h));
63
64         for(i = 0; i < RES_COL_N(_res); i++) {
65                 if (db_str2val(RES_TYPES(_res)[i], &(ROW_VALUES(_r)[i]),
66                             ((MYSQL_ROW)CON_ROW(_h))[i], lengths[i], 0) < 0) {
67                         LM_ERR("failed to convert value\n");
68                         LM_DBG("free row at %p\n", _r);
69                         db_free_row(_r);
70                         return -3;
71                 }
72         }
73         return 0;
74 }