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

 longtoptr()         Poke a long value into a memory address
------------------------------------------------------------------------------
 Declaration
   memory.hdr

 Syntax
   proc longtoptr extern
   param value long     gValue, ;
         value _POINTER pMem

 Arguments
   gValue is the value to place in memory.
   pMem is the target address.

 Return
   None.

 Description
   This procedure copies a long value into the specified memory location.

   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_longtoptr
   vardef
      ptr( long ) pMem        // pointer
   enddef
   pMem := malloc( 1000 )     // allocate working space
   ? dechex( *pMem )          // prints accidental value
   longtoptr( 0xbabababa, pMem ) // write a long to memory via function call
   ? dechex( *pMem )          // prints 0xBABABABA
   *pMem := 0xfefefefe        // write a long to memory via pointer
   ? dechex( *pMem )          // prints 0xFEFEFEFE
   free( pMem )               // free allocation
   endproc

   proc main
   Test_longtoptr()
   endproc