Delphi 变体类型(Variant)的介绍(流与变体类型的相互转换、变体类型常用的函数)
一、变体类型常用的函数介绍:
Variant: 一种可以拥有各种数据类型; 也可以告诉目前存储的数据是什么类型(通过使用VarType函数); 可以给相同的Variant分配不同的数据类型,只要Variant包含数字值就可以执行算法; variant数组只不过是variant型的数组,不必包含同类型的数据;
1、 VarArrayOf函数:更快捷的创建一维变体数组,可以创建全异的数值数组;
function VarArrayOf(const Values: array of Variant): Variant;
VarArrayOf是一种快速(写代码快而不是运行快)的方法生成一个一维Variant数据的方法,它接受一个Variant类型的Open
Array,用这个数据生成一个一维的Variant Array of
Variant(类型为Variant)。由于Delphi对Open Array类型参数的支持,使你可以用一行语句生成一个数组。不过它有两个缺陷:
只能生成一维数组;只能生成元素类型是Variant的数组。使用Variant数组, 与使用标准Delphi数组类似;
例如: MyArray := VarArrayOf(['李维', 30, '60', 60.369, 'China']);
2、 VarArrayCreate函数:
function VarArrayCreate(const Bounds: array of Integer; VarType: TVarType): Variant;
Bounds: 告诉数组的上下界; VarType: 决定了数组的中存储什么类型的数据。其它的数组(如二维、或者其他类型等)只能用VarArrayCreate去创建,并用循环给元素赋值。
例如:创建数组的数组, 可以模仿任何类型的数据结构类型:
VarArrayX := VarArrayCreate([1,10], varVariant);
数组的单个元素可以装载一个数组: VarArrayX[1] := VarArrayCreate([1,5], varVariant);
3、VarArrayHighBound、VarArrayLowBound函数:返回变体数组上/下限,从1开始(1:列;2:行;3:3维的最后一维)。
function VarArrayHighBound(const A: Variant; Dim: Integer): Integer;
4、VarArrayRedim函数:修改variant数组的最高限。
procedure VarArrayRedim(A: Variant; HighBound: Integer);
5、VarArrayDimCount函数:返回variant数组维数
unction VarArrayDimCount(const A: Variant): Integer;
6、VarArrayLock、VarArrayUnLock函数:避免运行时刻检查。一般用于初始化一个大数组。
function VarArrayLock(const A: Variant): Pointer;
procedure VarArrayUnlock(var A: Variant);
在对Variant数组的每一个元素进行赋值时,都要通过运行时逻辑来检查并判断数据类型的兼容性、每个元素的位置等等。为了避免运行时检 查,要用VarArrayLock()函数和VarArrayUnlock()过程。VarArrayLock()函数在内存中锁定数组,使数组不再移动 和改变大小,并能返回一个指向数组数据的指针。而VarArrayUnlock()过程用来对VarArrayLock()函数锁定的数组进行解锁,使数 组能重新移动或改变大小。在锁定数组后,能用更有效的方法对数组进行初始化。
7、VarArrayRef函数:获得variant指向的数据
function VarArrayRef(const A: Variant): Variant;
8、VarIsArray函数:是一个简单的布尔检查函数,判断是否是一个 Variant数组,是则返回True
function VarIsArray(const A: Variant): Boolean; overload;
function VarIsArray(const A: Variant; AResolveByRef: Boolean): Boolean; overload;
9、其他函数
1>、VarClear()过程清除Variant变量并将VType域的值设为varEmpty.
2>、VarCopy()将Source复制到Dest。
3>、VarCast()将一个Variant转换成指定的类型并存储在另一个Variant变量中。
4>、VarType()返回指定Variant的varXXX类型代码。
5>、VarAsType()跟VarCast()的功能一样。
6>、VarIsEmpty()如果一个Variant变量的类型代码是varEmpty则返回True。
7>、VarIsNull()判断Variant变量是否包含null值。
8>、VarToStr()将一个Variant变量转换成字符串表达式(如果Variant为varEmpty或varNUll则为空字符串)。
9>、VarFromDateTime()返回一个Variant变量,它存放着指定的TDateTime类型的值。
10>、VarToDateTime()返回在Variant中的TDateTime类型的值。
二、一个简单实例代码:
var
a, b: Variant;
I, J, K, M: Integer;
begin
//a是个一维Variant数组,元素类型是Variant,元素个数是3,上界是2,下界是0。
a := VarArrayOf([1234, 'abc ', Null]);
//b是一个16行4列的二维数组
b := VarArrayCreate[0, 3, 1, 16], varOleStr);
I := VarArrayHighBound(b, 1); // I是b的最大列号:3;
J := VarArrayLowBound(b, 1); // J是b的最小列号:0;
K := VarArrayHighBound(b, 2); // K是b的最大行号:16;
M := VarArrayLowBound(b, 2); // M是b的最小行号:1。
end;
注意,Variant数组下标是列在前,行在后,元素类型是PWideChar,最大列号是3,最小列号是0,最大行号是16,最小行号是1。
三、变体类型和流的相互转换
//1、 变体类型转成流
procedure VariantToStream(const Data: OleVariant; Stream: TStream);
var
p: Pointer;
begin
p := VarArrayLock(Data); // 加锁,并返回一个指针指向的数据。 避免运行时时刻检查
try
Stream.Write(p^, VarArrayHighBound(Data,1) + 1); // 返回最大的列号
finally
VarArrayUnlock(Data); // 解锁,使数组能重新移动或改变大小。
end;
end;
// 2、流转成变体类型
function StreamToVariant(Stream: TStream): OleVariant;
var
p: Pointer;
begin
Result := VarArrayCreate([0, Stream.Size - 1], varByte);// 创建一个以为的数组。类型为varByte
p := VarArrayLock(Result);
try
Stream.Position := 0; // 设置流的位置
Stream.Read(p^, Stream.Size);
finally
VarArrayUnlock(Result);
end;
end;