ACILobTrim()

ACILobTrim()

作用：

截断当前对象，返回指定长度的大对象。

语法：

sword ACILobTrim ( ACISvcCtx       *svchp,
                   ACIError        *errhp,
                   ACILobLocator   *locp,
                   ub4              newlen );

参数：

• svchp (IN)

服务上下文句柄

• errhp (IN/OUT)

错误句柄，该接口调用失败时，错误信息会存在该句柄上 ，调用 ACIErrorGet 获得错误信息。

• locp (IN/OUT)

一个单独的源大对象的内部大对象描述符指针，这个描述符指针必须是通过svchp句柄已经从服务器获得的。

• newlen (IN)

LOB值的新长度，必须小于或等于当前长度。 对于字符LOB，它是字符数。 对于二进制LOB和BFILE，它是LOB中的字节数。

说明：

此功能将LOB数据修整为指定的较短长度。 如果newlen大于当前的LOB长度，则该函数返回错误。 此功能仅对内部LOB有效。不适用BFILE类型。

可以在lob未打开时进行操作。但是，如果您确实在执行此操作之前打开了LOB，则必须在提交事务之前将其关闭。

如果未将LOB操作包装在打开或关闭API中，则每次写入LOB时都会自动打开和关闭。 这会对性能产生不利影响。建议您在open或close语句中包含对LOB的写操作。