'\" t
.\" Automatically generated by Pandoc 3.5
.\"
.TH "mysql_set_character_set" "3" "" "Version 3.3" "MariaDB Connector/C"
.SS Name
mysql_set_character_set \- Sets the default character set for connection
.SS Synopsis
.IP
.EX
#include \f[B]<mysql.h>\f[R]

int mysql_set_character_set(MYSQL * mysql,
                            const char * csname);
.EE
.SS Description
Sets the default character setfor the current connection.
Returns zero on success, non\-zero on failure.
.SS Parameters
.IP \[bu] 2
\f[CR]mysql\f[R] \- a mysql handle, which was previously allocated by
\f[B]mysql_init(3)\f[R] or \f[B]mysql_real_connect(3)\f[R].
.IP \[bu] 2
\f[CR]csname\f[R] \- character set name ### Notes
.IP \[bu] 2
It\[cq]s strongly recommended to use mysql_set_character_set() instead
of \f[CR]SET NAMES ...\f[R] since \f[B]mysql_real_escape_string(3)\f[R]
might fail or deliver unexpected results.
.SS Return value
Zero on success, non zero if an error occurred
.SS Supported character sets
The client library supports the following character sets:
.PP
.TS
tab(@);
lw(35.0n) lw(35.0n).
T{
Character set
T}@T{
Description
T}
_
T{
armscii8
T}@T{
8 bit character set for Armenian
T}
T{
ascii
T}@T{
US ASCII character set
T}
T{
big5
T}@T{
2 byte character set for traditional Chinese, Hongkong, Macau and Taiwan
T}
T{
binary
T}@T{
8 bit binary character set
T}
T{
cp1250
T}@T{
Windows code page 1250 character set
T}
T{
cp1251
T}@T{
Windows code page 1251 character set
T}
T{
cp1256
T}@T{
Windows code page 1256 character set
T}
T{
cp1257
T}@T{
Windows code page 1257 character set
T}
T{
cp850
T}@T{
MS\-DOS Codepage 850 (Western Europe)
T}
T{
cp852
T}@T{
MS\-DOS Codepage 852 (Middle Europe)
T}
T{
cp866
T}@T{
MS\-DOS Codepage 866 (Russian)
T}
T{
cp932
T}@T{
Microsoft Codepage 932 (Extension to sjis)
T}
T{
dec8
T}@T{
DEC West European
T}
T{
eucjpms
T}@T{
UJIS for Windows Japanese
T}
T{
euckr
T}@T{
EUC KR\-Korean
T}
T{
gb2312
T}@T{
GB\-2312 simplified Chinese
T}
T{
gbk
T}@T{
GBK simplified Chinese
T}
T{
geostd8
T}@T{
GEOSTD8 Georgian
T}
T{
greek
T}@T{
ISO 8859\-7 Greek
T}
T{
hebrew
T}@T{
ISO 8859\-8 Hebrew
T}
T{
hp8
T}@T{
HP West European
T}
T{
keybcs2
T}@T{
DOS Kamenicky Czech\-Slovak
T}
T{
koi8r
T}@T{
KOI8\-R Relcom Russian
T}
T{
koi8u
T}@T{
KOI8\-U Ukrainian
T}
T{
latin1
T}@T{
CP1252 Western European
T}
T{
latin2
T}@T{
ISO 8859\-2 Central Europe
T}
T{
latin5
T}@T{
ISO 8859\-9 Turkish
T}
T{
latin7
T}@T{
ISO 8859\-13 Baltic
T}
T{
macce
T}@T{
MAC Central European
T}
T{
macroman
T}@T{
MAC Western European
T}
T{
sjis
T}@T{
SJIS for Windows Japanese
T}
T{
swe7
T}@T{
7\-bit Swedish
T}
T{
tis620
T}@T{
TIS620 Thai
T}
T{
ucs2
T}@T{
UCS\-2 Unicode
T}
T{
ujis
T}@T{
EUC\-JP Japanese
T}
T{
utf8
T}@T{
UTF\-8 Unicode
T}
T{
utf16
T}@T{
UTF\-16 Unicode
T}
T{
utf32
T}@T{
UTF\-32 Unicode
T}
T{
utf8mb4
T}@T{
UTF 4\-byte Unicode
T}
.TE
.SS See also
.IP \[bu] 2
\f[B]mysql_get_character_set_info(3)\f[R]
.IP \[bu] 2
\f[B]mysql_real_escape_string(3)\f[R]