Navigation:  Reference > Functions By Category > Peek and Poke >

PeekWordNet()

Previous pageReturn to chapter overviewNext page

Retrieve the value of one or more WORDs from the memory buffer pointed by <pMem> starting at the position <nShift>.

Values are stored in network byte order, but retrieved in host byte order.

 

Syntax:

PeekWordNet(<pMem>,[[@]<nShift>]) -> <nWord>

PeekWordNet(<pMem>,[[@]<nShift>], <nItems>) -> <aWords>

 

Parameters:

<pMem>

Base pointer to the memory buffer.

 

<nShift>

Zero based starting position within <pMem>. Is this parameter is passed by reference will be increased with the number of bytes retrieved, to reuse it in subsequent calls to Peek...() functions.

 

<nItems>

Number of WORD values in network byte order to read and store as numeric elements in host byte order of the returned array.

 

Return Value:

Depending on the syntax used PeekDWord() can return the following values:

<nWordValue> Numeric value of the WORD pointed by <pMem> + <nShift>
<aWords>     Array of <nItems> elements containing the retrieved WORDs.