mirror of https://github.com/sipwise/kamailio.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
202 lines
5.8 KiB
202 lines
5.8 KiB
/*
|
|
* Copyright (C) 2001-2003 FhG Fokus
|
|
* Copyright (C) 2007-2008 1&1 Internet AG
|
|
*
|
|
* This file is part of Kamailio, a free SIP server.
|
|
*
|
|
* Kamailio is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version
|
|
*
|
|
* Kamailio is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
/**
|
|
* \file lib/srdb1/db_ut.h
|
|
* \brief Utility functions for database drivers.
|
|
*
|
|
* This utility methods are used from the database SQL driver to convert
|
|
* values and print SQL queries from the internal API representation.
|
|
* \ingroup db1
|
|
*/
|
|
|
|
#ifndef DB1_UT_H
|
|
#define DB1_UT_H
|
|
|
|
#include "../../pvar.h"
|
|
|
|
#include "db_key.h"
|
|
#include "db.h"
|
|
|
|
|
|
/**
|
|
* Converts a char into an integer value.
|
|
*
|
|
* \param _s source value
|
|
* \param _v target value
|
|
* \return zero on sucess, negative on conversion errors
|
|
*/
|
|
int db_str2int(const char* _s, int* _v);
|
|
|
|
|
|
/**
|
|
* Converts a char into an long long value.
|
|
*
|
|
* \param _s source value
|
|
* \param _v target value
|
|
* \return zero on sucess, negative on conversion errors
|
|
*/
|
|
int db_str2longlong(const char* _s, long long* _v);
|
|
|
|
|
|
/**
|
|
* Converts a char into a double value.
|
|
*
|
|
* \param _s source value
|
|
* \param _v target value
|
|
* \return zero on sucess, negative on conversion errors
|
|
*/
|
|
int db_str2double(const char* _s, double* _v);
|
|
|
|
|
|
/**
|
|
* Converts a integer value in a char pointer.
|
|
*
|
|
* \param _v source value
|
|
* \param _s target value
|
|
* \param _l available length and target length
|
|
* \return zero on sucess, negative on conversion errors
|
|
*/
|
|
int db_int2str(int _v, char* _s, int* _l);
|
|
|
|
|
|
/**
|
|
* Converts a long long value in a char pointer.
|
|
*
|
|
* \param _v source value
|
|
* \param _s target value
|
|
* \param _l available length and target length
|
|
* \return zero on sucess, negative on conversion errors
|
|
*/
|
|
int db_longlong2str(long long _v, char* _s, int* _l);
|
|
|
|
|
|
/**
|
|
* Converts a double value into a char pointer.
|
|
*
|
|
* \param _v source value
|
|
* \param _s target value
|
|
* \param _l available length and target length
|
|
* \return zero on sucess, negative on conversion errors
|
|
*/
|
|
int db_double2str(double _v, char* _s, int* _l);
|
|
|
|
|
|
/**
|
|
* Convert a time_t value to string.
|
|
*
|
|
* \param _v source value
|
|
* \param _s target value
|
|
* \param _l available length and target length
|
|
* \return zero on sucess, negative on conversion errors
|
|
* \todo This functions add quotes to the time value. This
|
|
* should be done in the val2str function, as some databases
|
|
* like db_berkeley don't need or like this at all.
|
|
*/
|
|
int db_time2str(time_t _v, char* _s, int* _l);
|
|
|
|
int db_time2str_ex(time_t _v, char* _s, int* _l, int _qmode);
|
|
|
|
/**
|
|
* Converts a char into a time_t value.
|
|
*
|
|
* \param _s source value
|
|
* \param _v target value
|
|
* \return zero on sucess, negative on conversion errors
|
|
*/
|
|
int db_str2time(const char* _s, time_t* _v);
|
|
|
|
|
|
/**
|
|
* Print columns for a SQL statement, separated by commas.
|
|
*
|
|
* \param _b target char
|
|
* \param _l length of the target
|
|
* \param _c keys that should be printed
|
|
* \param _n number of keys
|
|
* \param _tq char to quote special tokens or empty string
|
|
* \return the length of the printed result on success, negative on errors
|
|
*/
|
|
int db_print_columns(char* _b, const int _l, const db_key_t* _c, const int _n, const char *_tq);
|
|
|
|
|
|
/**
|
|
* Print values for a SQL statement.
|
|
*
|
|
* \param _c structure representing database connection
|
|
* \param _b target char
|
|
* \param _l length of the target
|
|
* \param _v values that should be printed
|
|
* \param _n number of values
|
|
* \param (*val2str) function pointer to a db specific conversion function
|
|
* \return the length of the printed result on success, negative on errors
|
|
*/
|
|
int db_print_values(const db1_con_t* _c, char* _b, const int _l, const db_val_t* _v,
|
|
const int _n, int (*val2str)(const db1_con_t*, const db_val_t*, char*, int*));
|
|
|
|
|
|
/**
|
|
* Print where clause for a SQL statement.
|
|
*
|
|
* \param _c structure representing database connection
|
|
* \param _b target char
|
|
* \param _l length of the target
|
|
* \param _k keys that should be printed
|
|
* \param _o optional operators
|
|
* \param _v values that should be printed
|
|
* \param _n number of key/value pairs
|
|
* \param (*val2str) function pointer to a db specific conversion function
|
|
* \return the length of the printed result on success, negative on errors
|
|
*/
|
|
int db_print_where(const db1_con_t* _c, char* _b, const int _l, const db_key_t* _k,
|
|
const db_op_t* _o, const db_val_t* _v, const int _n, int (*val2str)
|
|
(const db1_con_t*, const db_val_t*, char*, int*));
|
|
|
|
|
|
/**
|
|
* Print set clause for a SQL statement.
|
|
*
|
|
* \param _c structure representing database connection
|
|
* \param _b target char
|
|
* \param _l length of the target
|
|
* \param _k keys that should be printed
|
|
* \param _v vals that should be printed
|
|
* \param _n number of key/value pairs
|
|
* \param (*val2str) function pointer to a db specific conversion function
|
|
* \return the length of the printed result on success, negative on errors
|
|
*/
|
|
int db_print_set(const db1_con_t* _c, char* _b, const int _l,
|
|
const db_key_t* _k, const db_val_t* _v, const int _n, int (*val2str)
|
|
(const db1_con_t*, const db_val_t*, char*, int*));
|
|
|
|
|
|
/**
|
|
* Convert db_val_t to pv_spec_t
|
|
*
|
|
* \param msg sip msg structure
|
|
* \param dbval database value
|
|
* \param pvs pv_spec where to put the database value
|
|
* \return 0 on success, -1 on failure
|
|
*/
|
|
int db_val2pv_spec(struct sip_msg* msg, db_val_t *dbval, pv_spec_t *pvs);
|
|
|
|
#endif
|