String类型接口
在OCI中OCIString类型只支持从数据库获取数据，而不支持插入。
OCIStringAllocSize
功能描述
以字节为单位获取分配的字符串内存大小。
功能说明
分配的大小大于或等于实际字符串大小。
接口信息
函数/过程
OCIStringAllocSize 的语法如下：
sword OCIStringAllocSize ( OCIEnv *env,
OCIError *err,
const OCIString *vs,
ub4 *allocsize );
参数解释如下：
- env(IN/OUT)：以对象模式初始化的 OCI 环境句柄。 有关详细信息，请参阅 OCIEnvCreate()、OCIEnvNlsCreate() 和 OCIInitialize()（已弃用）的描述。
- err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。 通过调用 OCIErrorGet()获取诊断信息。
- vs(IN)：输入的OCIString类型。
- allocsize(OUT)：输出的字符串内存大小。
其他说明
无
OCIStringAssign
功能描述
将一个字符串分配给另一个字符串。
功能说明
将 rhs 字符串分配给 lhs 字符串。 可以根据 rhs 的大小调整 lhs 字符串的大小。 分配的字符串以 NULL 结尾。 长度字段不包括 NULL 终止所需的额外代码点或字节。
接口信息
函数/过程
OCIStringAssign的语法如下：
sword OCIStringAssign ( OCIEnv *env,
OCIError *err,
const OCIString *rhs,
OCIString **lhs );
参数解释如下：
- env(IN/OUT)：以对象模式初始化的 OCI 环境句柄。 有关详细信息，请参阅 OCIEnvCreate()、OCIEnvNlsCreate() 和 OCIInitialize()（已弃用）的描述。
- err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。 通过调用 OCIErrorGet()获取诊断信息。
- rhs(IN)：输入的OCIString类型，右操作类型。
- lhs(OUT)：输出的OCIString类型，左操作类型。
其他说明
无
OCIStringAssignText
功能描述
将源文本字符串分配给目标字符串。
功能说明
将 rhs 字符串分配给 lhs 字符串。 lhs 字符串可以根据 rhs 的大小调整大小。 分配的字符串以 NULL 结尾。 长度字段不包括 NULL 终止所需的额外字节或代码点。
接口信息
函数/过程
OCIStringAssignText的语法如下：
sword OCIStringAssignText ( OCIEnv *env,
OCIError *err,
const OraText *rhs,
ub4 rhs_len,
OCIString **lhs );
参数解释如下：
- env(IN/OUT)：以对象模式初始化的 OCI 环境句柄。 有关详细信息，请参阅 OCIEnvCreate()、OCIEnvNlsCreate() 和 OCIInitialize()（已弃用）的描述。
- err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。 通过调用 OCIErrorGet()获取诊断信息。
- rhs(IN)：输入的OraText类型，右操作类型。
- rhs_len(IN)：输入的OraText类型rhs长度。
- lhs(OUT)：输出的OCIString类型，左操作类型。
其他说明
无
OCIStringPtr
功能描述
获取指向给定字符串文本的指针。
功能说明
获取指向给定字符串文本的指针。
接口信息
函数/过程
OCIStringPtr的语法如下：
text *OCIStringPtr ( OCIEnv *env,
const OCIString *vs );
参数解释如下：
- env(IN/OUT)：以对象模式初始化的 OCI 环境句柄。 有关详细信息，请参阅 OCIEnvCreate()、OCIEnvNlsCreate() 和 OCIInitialize()（已弃用）的描述。
- vs (IN)：指向返回其字符串的 OCIString 对象的指针。 如果 vs 是 UTF-16 格式，则返回的缓冲区也是 UTF-16 格式。 要确定返回缓冲区的编码，请检查 OCIString 与自身中的 UTF-16 信息，因为不能保证特定的 OCIString 将具有与 env 相同的设置。 检查对象 OCI 函数，该函数旨在检查对象中的成员字段。
其他说明
无
OCIStringResize
功能描述
调整给定字符串的内存大小。
功能说明
此函数调整对象缓存中给定可变长度字符串的内存大小。 不保留字符串的内容。 该函数可以将字符串分配到一个新的内存区域，在这种情况下，给定字符串占用的原始内存被释放。 如果 str 为 NULL，则此函数为字符串分配内存。 如果 new_size 为 0，则该函数释放 str 占用的内存并返回 NULL 指针值。
接口信息
函数/过程
OCIStringResize的语法如下：
sword OCIStringResize ( OCIEnv *env,
OCIError *err,
ub4 new_size,
OCIString **str );
参数解释如下：
- env(IN/OUT)：以对象模式初始化的 OCI 环境句柄。 有关详细信息，请参阅 OCIEnvCreate()、OCIEnvNlsCreate() 和 OCIInitialize()（已弃用）的描述。
- err(IN/OUT)：OCI 错误句柄。如果有错误，则记录在err中，并且该函数返回OCI_ERROR。 通过调用 OCIErrorGet()获取诊断信息。
- new_size(IN)：字符串的新内存大小（以字节为单位）。 new_size 参数必须包含 NULL 字符的空格作为字符串终止符。
- str(OUT)：为从 OCI 对象缓存中释放的字符串分配的内存。。
其他说明
无
OCIStringSize
功能描述
获取给定字符串的大小vs。
功能说明
返回的大小不包括用于 NULL 终止的额外字节。
接口信息
函数/过程
OCIStringSize 的语法如下：
ub4 OCIStringSize ( OCIEnv *env,
const OCIString *vs );
参数解释如下：
- env(IN/OUT)：以对象模式初始化的 OCI 环境句柄。 有关详细信息，请参阅 OCIEnvCreate()、OCIEnvNlsCreate() 和 OCIInitialize()（已弃用）的描述。
- vs (IN)：返回其大小的字符串，以字节数为单位。
其他说明
无
