Topic Path: Symbol Reference > Classes > TIdBuffer Class > TIdBuffer Methods > ExtractToIPv6 Method
ContentsIndexHome
PreviousUpNext
TIdBuffer.ExtractToIPv6 Method

Reads and optionally removes a Cardinal value from the internal storage for the buffer.

function ExtractToIPv6(
    const AIndex: Integer
): TIdIPv6Address;
Parameters 
Description 
AIndex 
Postion in the buffer where bytes for the data type are stored. 

TIdIPv6Address - IPv6 address read from the internal storage for the buffer.

ExtractToIPv6 is a TIdIPv6Address function used to read and optionally remove an IPv6 address from the internal storage for the buffer. 

AIndex is the zero-based offset of the byte value to extract from the internal storage for the buffer. AIndex normally contains a value in the range 0 (zero) to Size-1. When AIndex contains 0 or a positive value, the content in the buffer is not altered by the Extract operation. 

Using a negative value in AIndex indicates that data is being accessed sequentially and calls Remove to adjust the current buffer position and the space allocated for the buffer by the size for the ordinal data type. 

ExtractToIPv6 calls the BytesToIPv6 routine to convert the byte values in the buffer to the data type used in the return value for the method. The converted data type is adjusted from network byte order to host-specific byte order using the NetworkToHost method in GStack for the operating system or platform. 

Use one of the other Extract methods to read a specific data type from the internal storage for the buffer: 

 

Method 
Storage Data Type 
String 
Byte 
Cardinal 
ExtractToIPv6 
Int64 
Word 

 

Use IndexOf to find the position in the buffer where a specific sequence of byte values is located.

Exceptions 
Description 
Raised with RSNotEnoughDataInBuffer and the requested byte count. 
Copyright © 1993-2006, Chad Z. Hower (aka Kudzu) and the Indy Pit Crew. All rights reserved.
Post feedback to the Indy Docs Newsgroup.