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

 ptrtobyte()         Read a byte from a memory address
------------------------------------------------------------------------------
 Declaration
   memory.hdr

 Syntax
   func byte ptrtobyte extern
   param value _POINTER pMem

 Arguments
   pMem is a memory address.

 Return
   A byte value.

 Description
   This function returns the byte located at the specified memory address.

   The function 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

   // address in BIOS data area where number of hard disks is stored
   #define BIOS_NUMDISKS 0x00400075
   
   proc Test_ptrtobyte
   vardef
      ptr( byte ) pMem
   enddef
   ? ptrtobyte( BIOS_NUMDISKS ) // get value using function call
   pMem := BIOS_NUMDISKS        // get value using pointer
   ? *pMem
   endproc

   proc main
   Test_ptrtobyte()
   endproc