8785481999-07-01Henrik Grubbström (Grubba) /*
9bcbd22007-05-03Martin Stjernholm  * $Id: sql_util.pmod,v 1.19 2007/05/03 13:57:35 mast Exp $
8785481999-07-01Henrik Grubbström (Grubba)  * * Some SQL utility functions. * They are kept here to avoid circular references. * * Henrik Grubbström 1999-07-01 */
a580e12000-09-27Fredrik Hübinette (Hubbe) #pike __REAL_VERSION__
a20af62000-09-26Fredrik Hübinette (Hubbe) 
36d2b82001-09-06Martin Nilsson //! Some SQL utility functions
8785481999-07-01Henrik Grubbström (Grubba) 
36d2b82001-09-06Martin Nilsson //! Quote a string so that it can safely be put in a query. //! //! @param s //! String to quote.
8785481999-07-01Henrik Grubbström (Grubba) string quote(string s) {
18096f2003-08-22Martin Nilsson  return replace(s, "\'", "\'\'");
8785481999-07-01Henrik Grubbström (Grubba) }
36d2b82001-09-06Martin Nilsson //! Throw an error in case an unimplemented function is called.
485cb11999-07-01Henrik Grubbström (Grubba) void fallback()
8785481999-07-01Henrik Grubbström (Grubba) {
5d16962003-04-22Martin Nilsson  error( "Function not supported in this database." );
8785481999-07-01Henrik Grubbström (Grubba) }
6458a72000-04-29Francesco Chemolli 
580be42001-12-04Martin Nilsson //! Build a raw SQL query, given the cooked query and the variable bindings
36d2b82001-09-06Martin Nilsson //! It's meant to be used as an emulation engine for those drivers not //! providing such a behaviour directly (i.e. Oracle). //! The raw query can contain some variables (identified by prefixing
580be42001-12-04Martin Nilsson //! a colon to a name or a number (i.e. ":var" or ":2"). They will be
36d2b82001-09-06Martin Nilsson //! replaced by the corresponding value in the mapping. //! //! @param query
580be42001-12-04Martin Nilsson //! The query.
36d2b82001-09-06Martin Nilsson //! //! @param bindings //! Optional mapping containing the variable bindings. Make sure that //! no confusion is possible in the query. If necessary, change the //! variables' names.
4903d52000-04-29Francesco Chemolli string emulate_bindings(string query, mapping(string|int:mixed)|void bindings, void|object driver)
6458a72000-04-29Francesco Chemolli { array(string)k, v; if (!bindings) return query;
580be42001-12-04Martin Nilsson  function my_quote=(driver&&driver->quote?driver->quote:quote);
981f832005-04-10Martin Nilsson  v=map(values(bindings), lambda(mixed m) { if(multisetp(m)) m = indices(m)[0]; return (stringp(m)? "'"+my_quote(m)+"'" : (string)m); });
580be42001-12-04Martin Nilsson  // Throws if mapping key is empty string.
981f832005-04-10Martin Nilsson  k=map(indices(bindings),lambda(string s){ return ( (stringp(s)&&s[0]==':') ? s : ":"+s); });
6458a72000-04-29Francesco Chemolli  return replace(query,k,v); }
e796fc2006-08-09Henrik Grubbström (Grubba)  //! Result object wrapper performing utf8 decoding of all fields. class UnicodeWrapper (
02a56d2006-12-30Martin Nilsson  // The wrapped result object.
e796fc2006-08-09Henrik Grubbström (Grubba)  static object master_result ) { //! Returns the number of rows in the result. int num_rows() { return master_result->num_rows(); } //! Returns the number of fields in the result. int num_fields() { return master_result->num_fields(); } //! Returns @expr{1@} if there are no more rows in the result. int(0..1) eof() { return master_result->eof(); } //! Cached @[fetch_fields()] result. static array(int|mapping(string:mixed)) field_info; //! Returns Information about the fields in the result. //! //! The following fields are converted from UTF8 if present: //! @mapping //! @member string "name" //! The name of the field. Always present. //! @member string "table" //! The table the field is from. Not present from all databases. //! @member string "default" //! The default value for the column. Not available from all databases. //! @endmapping array(int|mapping(string:mixed)) fetch_fields() { if (!field_info) { field_info = master_result->fetch_fields(); foreach(field_info, int|mapping(string:mixed) field) { if (mappingp(field)) { field->name = utf8_to_string(field->name); if (field->table) { field->table = utf8_to_string(field->table); } if (field->default) { field->default = utf8_to_string(field->default); } } } } return field_info; } //! Skip ahead the specified number of rows. void seek(int rows) { master_result->seek(rows); } //! Fetch the next row from the result. //! //! All strings in the result are decoded from UTF8. int|array(string) fetch_row() { int|array(string) row = master_result->fetch_row(); if (!arrayp(row)) return row;
cd16882006-08-11Henrik Grubbström (Grubba)  array(int|mapping(string:mixed)) field_info = fetch_fields();
e796fc2006-08-09Henrik Grubbström (Grubba)  foreach(row; int i; string|int val) {
8877692006-11-17Martin Stjernholm  if (stringp(val)) { row[i] = utf8_to_string(val); } } return row; } } #if constant (Mysql.mysql.HAVE_MYSQL_FIELD_CHARSETNR)
77ac702006-11-27Martin Stjernholm 
8877692006-11-17Martin Stjernholm class MySQLUnicodeWrapper //! Result wrapper for MySQL that performs UTF-8 decoding of all //! nonbinary fields. Useful if the result charset of the connection //! has been set to UTF-8. //! //! @note //! There's normally no need to use this class directly. It's used //! automatically when @[Mysql.set_unicode_decode_mode] is activated. { inherit UnicodeWrapper; int|array(string) fetch_row() { int|array(string) row = master_result->fetch_row(); if (!arrayp(row)) return row; array(int|mapping(string:mixed)) field_info = fetch_fields(); foreach(row; int i; string|int val) { if (stringp(val) && field_info[i]->charsetnr != 63) {
e796fc2006-08-09Henrik Grubbström (Grubba)  row[i] = utf8_to_string(val); } } return row; } }
77ac702006-11-27Martin Stjernholm  #else class MySQLBrokenUnicodeWrapper
9bcbd22007-05-03Martin Stjernholm // This one is used to get a buggy unicode support when compiled with // an old MySQL client lib that doesn't have the charsetnr property in // the field info. It looks at the binary flag instead, which is set // for binary fields but might also be set for text fields (e.g. with // a definition like "VARCHAR(255) BINARY").
77ac702006-11-27Martin Stjernholm // // I.e. the effect of using this one is that text fields with the
9bcbd22007-05-03Martin Stjernholm // binary flag won't be correctly decoded in unicode decode mode. // // This has to be enabled either by passing "broken-unicode" as // charset to Sql.mysql.create or Sql.mysql.set_charset, by calling // Sql.mysql.set_unicode_decode_mode(-1), or by defining the // environment variable PIKE_BROKEN_MYSQL_UNICODE_MODE. That will // cause this buggy variant to be used if and only if the MySQL client // lib doesn't support the charsetnr property.
77ac702006-11-27Martin Stjernholm { inherit UnicodeWrapper; int|array(string) fetch_row() { int|array(string) row = master_result->fetch_row(); if (!arrayp(row)) return row; array(int|mapping(string:mixed)) field_info = fetch_fields(); foreach(row; int i; string|int val) { if (stringp(val) && field_info[i]->flags && !field_info[i]->flags->binary) { row[i] = utf8_to_string(val); } } return row; } }
8877692006-11-17Martin Stjernholm #endif