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

 ptrtochar()         Read a string from a memory address
------------------------------------------------------------------------------
 Declaration
   memory.hdr

 Syntax
   func char ptrtochar extern
   param value _POINTER pMem

 Arguments
   pMem is a memory address.

 Return
   A char value.

 Description
   This function returns the char 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

   #define BIOS_DATE 0xffff0005 // BIOS ROM date address (most machines)
   
   proc Test_ptrtochar
   vardef
      ptr( char ) pMem
   enddef
   ? ptrtochar( BIOS_DATE )     // get value using function call
   pMem := BIOS_DATE            // get value using pointer
   ? *pMem
   endproc

   proc main
   Test_ptrtochar()
   endproc