gbase数据、南大通用产品文档：GBase8aHEX(N_or_S)

函数说明
返回参数对应的十六进制值。如果N_or_S 是一个数字，则返回它的十六进制字
符串形式，在这里，N 是一个BIGINT 数，相当于CONV(N,10,16)；如果N_or_S
是一个字符串，则返回每个字符对应的十六进制形式，其中每个字符被转化为两
个十六进制数字。以0xff 形式出现的字符串是此函数的反转操作，此时，将每两
位十六进制转换成其ASCII 码输出一个字符。
示例
示例1：N_or_S 值为数字。
gbase> SELECT HEX(255) FROM dual;
+----------+
| HEX(255) |
+----------+
| FF
|
+----------+
1 row in set
示例2：N_or_S 值为字符串。
gbase> SELECT HEX('abc') FROM dual;
+------------+
| HEX('abc') |
+------------+

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
689
| 616263
|
+------------+
1 row in set
示例3：以0xff 形式出现的字符串是HEX(N_or_S)函数的反转操作。
gbase> SELECT 0x616263 FROM dual;
+----------+
| 0x616263 |
+----------+
| abc
|
+----------+
1 row in set

消息文本通常是 SQLException 对象的文本，但也可以是 SQLWarn 对象或任何其它来自驱
动程序的文本输出。
启用全球化消息文本输出有两个要求，如下所示：

必须将 ifxlang.jar 文件的完整路径名添加到 $CLASSPATH（UNIX™）
或 %CLASSPATH%（Windows™）环境变量。此 JAR 文件包含GBase 8s JDBC
Driver 支持的所有全球化版本的消息文本。支持的语言是英语和中文。

如果您使用的是非缺省语言环境，
则 CLIENT_LOCALE 环境变量值必须在连接时
通过属性列表传递给连接对象。
有关一般的 CLIENT_LOCALE 和 GLS 功能，
请
参阅 支持 GBase 8s GLS 变量.
多个公共类具有将当前连接对象作为参数的构造函数，以便可以直接存
取 CLIENT_LOCALE 值。如果您希望访问非英文的错误消息，则必须使用包含此连接对象
的构造函数。否则，任何来自这些类的消息文本仅为英文。受影响的公共类为 Interval 、
IntervalYM 、IntervalDF 和 IfxLocator。有关这些类的构造函数的更多信息，请参阅 操作
GBase 8s 类型。
有关如何使用全球化错误消息支持功能的示例，请参阅 GBase 8s JDBC Driver 附带
的 locmsg.java 程序。

8 调优和故障排除
这些主题提供 GBase 8s JDBC Driver 的调优和故障排除信息。

 摘要：
该函数用于初始化GBase CAPI 库。在使用GBase CAPI 之前必须调用该函



GBase 8a 程序员手册C API 篇
南大通用数据技术股份有限公司

- 43 -
数。gbase_init 函数内部会调用gbase_library_init，以确保使用GBase
CAPI
库使用时调用了gbase_library_init。
 语法：
int gbase_library_init(int argc, char **argv, char **groups);
 参数：
argc
取值0
argv 取值NULL
groups 取值NULL
 返回值：
0 表示成功，非0 值表示出现错误。