[转]Delphi 变体类型（Variant）的介绍（流与变体类型的相互转换变体类型常用的函数）

Posted 2020-07-31

 

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;