VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

PQescapeString

功能描述

PQescapeString是一个老的,已经被PQescapeStringConn弃用了的版本。与PQescapeStringConn接口功能相同,用于转义字符串常量。

接口原型

size_t PQescapeString (char *to, const char *from, size_t length);

参数说明

参数名 参数说明
to 函数将转义结果字符串写到to指针指向的内存。to应该指向一个包含至少多于两倍 length大小的缓冲区,要么就不会定义该行为。如果to和from 字符串交叠,那么也不会定义该行为。
from from 参数指向用以转义的输入字符串的第一个字符。
length from字符串长度。若在达到此长度之前,str串中出现了’\0’,则在’\0’处结束;否则以length长度结束,此行为类似于strncpy。

返回值

PQescapeString返回写到to的字节数,’\0’字符不计入。

其他

与PQescapeStringConn唯一的不同是,PQescapeString 不使用PGconn或error参数。因此,不能够根据连接属性 (如字符编码)来调整其行为,因此可能会给出错误的结果,同样,不会报告错误条件。PQescapeString可以在客户端编程(一次只有一个连接) 中安全的使用。在这种情况下,它可以找到额外信息。在其他情况下, 这是一个安全隐患,使用PQescapeStringConn时应该避免。