GetTagDataLength

The GetTagDataLength method retrieves the length in bytes of the data for the specified tag handle.

NOTE:  For the String data type the returned size includes one byte for a NULL terminator.

LONG GetTagDataLength(
  LONG TagHandle // Handle of tag to be queried
)

Parameters:
TagHandle Tag to be queried for length.

Return Values:
Length of tag data.

Example:
var Tl, Th, TagInfo;

Tl = CAS.New();
CAS.AddTag(Tl,"SUBJECT","This is a test.");

if ((Th = CAS.GetTagHandle(Tl,"SUBJECT",0)) != null)
  {
  TagInfo  = "Tag ID is " + CAS.GetIdFromHandle(Th) + "\r\n";
  TagInfo += "Tag data is " + CAS.GetTagData(Th) + "\r\n";
  TagInfo += "Tag data length is " + CAS.GetTagDataLength(Th) + "\r\n";
  TagInfo += "Tag data type is " + CAS.GetTagDataType(Th) + "\r\n";

  CAS.RetTagHandle(Th);
  }
else
  {
  TagInfo = "Tag not found";
  }

CAS.Delete(Tl);

The contents of TagInfo will be:

Tag ID is 832
Tag data is This is a test.
Tag data length is 16
Tag data type is 1


See Also:
CAS GetTagHandle, CAS GetTag