Click above to get retro games delivered to your door ever month!

 peekw()             Return the word at a memory address
------------------------------------------------------------------------------
 Declaration
   memory.hdr

 Syntax
   func uint peekw extern
   param value uint uSegment, ;
         value uint uOffset

 Arguments
   uSegment is a segment address.
   uOffset is an offset address.

 Return
   The 2-byte word value found at the specified memory address.

 Description
   The peek() function returns the contents of a 2-byte object (word or uint) in
   memory whose address is specified by the parameters uSegment and uOffset.

   The procedure is included for compatibility with earlier Force versions.
   Use the ptr() data type in conjunction with the & and * operators for
   directly writing to explicit memory addresses.

 Example
   #define EXAMPLE_MEMORY
   #include example.hdr

   proc Test_peekw
   vardef
      ptr( uint ) pMem
   enddef
   // read the number of screen colums from BIOS data area
   ? peekw( 0x0040, 0x004a )        // using function call
   pMem := 0x0040004a               // using pointer
   ? *pMem
   endproc

   proc main
   Test_peekw()
   endproc