pb函数库之Blob(大二进制对象)函数

Blob()
Blob()功能将字符串转换成Blob类型数据。
语法Blob ( text )
参数text： string类型，指定要转换的数据返回值Blob。函数执行成功时返回转换后的Blob类型数据；如果text参数的值为NULL，则Blob()函数返回NULL。
--------------------------------------------------------------------------------

BlobEdit()
功能将任意类型的数据插入到Blob类型变量的指定位置。
语法BlobEdit ( blobvariable, n, data )
参数blobvariable：Blob类型的已初始化变量，将向该变量中插入数据n：指定插入位置，有效值在1到4,294,967,295之间data：要插入到Blob类型变量中的数据，其数据类型可以是任何有效的PowerBuilder数据类型返回值Unsigned long。函数执行成功时返回下次可以插入数据的位置；如果blobvariable变量中空间不够或任何参数的值为NULL，则BlobEdit()函数返回NULL。
--------------------------------------------------------------------------------

BlobMid()
功能从Blob变量中提取出一段数据。提取之后，原Blob变量内容不变。
语法BlobMid ( data, n {, length } )
参数data：Blob类型的数据n：指定要提取数据的起始位置，有效值在1到4,294,967,295之间length：可选项，指定要提取数据的长度，以字节为单位，有效值在1到4,294,967,295之间。缺省时提取从指定位置n到末尾的所有数据返回值Blob。函数执行成功时返回指定字节数的数据。如果n的值大于data的字节数，函数返回空。如果n与length的和超过了data数据的字节数，那么BlobMid()函数返回剩下的数据，数据长度将小于参数length的值。如果任何参数的值为NULL，则BlobMid()函数返回NULL。
--------------------------------------------------------------------------------

Len()
功能得到Blob类型变量的数据长度，以字节为单位。
语法Len ( blob )
参数blob：Blob类型变量返回值Long。函数执行成功时返回blob变量的长度，发生错误时返回-1。如果任何参数的值为NULL，则Len()函数返回NULL。用法如果在说明Blob类型的变量时指定了变量长度，那么对该变量来说，Len()函数得到的就是这个指定的长度。如果在变量说明时未指定变量长度，那么PowerBuilder在赋值时调整长度，未赋值Blob类型变量的长度为0。
--------------------------------------------------------------------------------

String()
功能将Blob类型变量的值转换成字符串类型。如果Blob类型变量的值不是文本型数据，String()函数将其值解释成字符。
语法String ( blob )
参数blob：要对其值进行类型转换的Blob类型变量返回值String。函数执行成功时返回转换后的数据，失败时返回空字符串（""）。如果blob变量中包含的数据不是字符串类型的数据，那么String()函数尽可能把数据解释为字符，并返回字符串类

型数据。如果blob参数的值为NULL，则String()函数返回NULL。