File: mysql_select_db.3

package info (click to toggle)
mariadb 1%3A10.11.14-0%2Bdeb12u2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 614,128 kB
  • sloc: ansic: 2,421,226; cpp: 1,765,048; asm: 381,336; perl: 62,256; java: 39,363; pascal: 38,841; sh: 38,242; sql: 19,830; yacc: 19,731; xml: 10,414; python: 10,125; ruby: 8,544; cs: 6,542; makefile: 6,155; ada: 1,879; lex: 1,207; javascript: 996; objc: 80; tcl: 73; awk: 46; php: 22
file content (74 lines) | stat: -rw-r--r-- 2,025 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_select_db" "3" "" "Version 3.3" "MariaDB Connector/C"
.SS Name
mysql_select_db \- selects a database as default
.SS Synopsis
.IP
.EX
#include \f[B]<mysql.h>\f[R]

int mysql_select_db(MYSQL * mysql,
                    const char * db);
.EE
.SS Description
Selects a database as default.
Returns zero on success, non\-zero on failure
.SS Parameters
.IP \[bu] 2
\f[CR]mysql\f[R] is a connection identifier, which was previously
allocated by \f[B]mysql_init(3)\f[R] and connected by
\f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2
\f[CR]db\f[R] \- the default database name
.SS Notes
.IP \[bu] 2
To retrieve the name of the default database either execute the SQL
command \f[CR]SELECT DATABASE()\f[R] or retrieve the value via
\f[B]mariadb_get_infov(3)\f[R] API function.
.IP \[bu] 2
The default database can also be set by the db parameter in
\f[B]mysql_real_connect(3)\f[R].
.SS Examples
.SS SQL
.IP
.EX
# \f[B]switch\f[R] \f[B]to\f[R] \f[B]default\f[R] \f[B]database\f[R] test
\f[B]USE\f[R] test;
# \f[B]check\f[R] \f[B]default\f[R] \f[B]database\f[R]
\f[B]SELECT\f[R] \f[B]DATABASE\f[R]();
+\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
| \f[B]database\f[R]() |
+\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
| test       |
+\f[I]\-\-\-\-\-\-\-\-\-\-\-\-+\f[R]
.EE
.SS MariadDB Connector/C
.IP
.EX
static int set_default_db(MYSQL *mysql)
{
  int rc;
  char *default_db;

  \f[I]/* change default database to test */\f[R]
  rc= mysql_select_db(mysql, \[dq]test\[dq]);
  \f[B]if\f[R] (rc)
    \f[B]return\f[R] rc;  \f[I]/* Error */\f[R]

  \f[I]/* get the default database */\f[R]
  rc= mariadb_get_infov(mysql, MARIADB_CONNECTION_SCHEMA, &default_db);
  \f[B]if\f[R] (rc)
    \f[B]return\f[R] rc; \f[I]/* Error */\f[R]

  \f[B]if\f[R] (strcmp(\[dq]test\[dq], default_db) != NULL)
  {
    printf(\[dq]Wrong default database\[rs]n\[dq]);
    \f[B]return\f[R] 1;
  }
  printf(\[dq]Default database: %s\[dq], default_db);
  \f[B]return\f[R] 0;
}
.EE
.SS See also
\f[B]mysql_real_connect(3)\f[R]