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时应该避免。