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
|
.\" msqlQuery - Send a SQL query to the engine
.\" Copyright (c) 1996 Martin Schulze <joey@office.individual.net>
.\"
.\" This program 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.
.\"
.\" This program 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.,59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
.\"
.\" This manual page is written especially for Debian GNU/Linux.
.\"
.TH msqlQuery 3 "4 Aug 1996" "Mini SQL" "mSQL Programmer's Manual"
.SH NAME
msqlQuery \- Send a SQL query to the engine
.SH SYNOPSYS
.nf
.B #include <msql.h>
.sp
.BI "int msqlQuery(int " sock ", char *" query );
.fi
.SH DESCRIPTION
Queries are sent to the engine over the connection associated with
.I sock
as plain text strings using
.BR msqlQuery() .
If the query generates output from the engine, such as a SELECT
statement, the data is buffered in the API waiting for the application
to retrieve it. If the application submits another query before it
retrieves the data using
.BR msqlStoreResult (3),
the buffer will be overwritten by any data generated by the new query.
.SH "RETURN VALUE"
On success a value of 0 is returned. If an error occurs, a value of
\-1 is returned and the variable
.I msqlErrmsg
contains an appropriate text message. This variable is defined in
.IR <msql.h> .
.SH "SEE ALSO"
.BR msqlConnect (3),
.BR msqlSelectDB (3),
.BR msqlStoreResult (3),
.BR msqlClose (3),
.BR msqld (8),
.BR msql (5).
|
