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

 inttosegoff()       Poke an int value into a segment/offset address
------------------------------------------------------------------------------
 Declaration
   memory.hdr

 Syntax
   proc inttosegoff extern
   param value int  iValue, ;
         value uint uSegment, ;
         value uint uOffset

 Arguments
   iValue is the value to place in memory.
   uSegment is the target segment address.
   uOffset is the target offset address.

 Return
   None.

 Description
   This procedure copies an int 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_inttosegoff
   vardef
      ptr( int ) pMem         // pointer
      uint        nSeg, nOff  // segment and offset
   enddef
   pMem := malloc( 1000 )     // allocate working space
   splitptr( nSeg, nOff, pMem ) // obtain segment and offset values
   ? *pMem                    // prints accidental value
   inttosegoff( 22000, nSeg, nOff ) // write an int to memory via function call
   ? *pMem                    // prints 22000
   *pMem := 9876              // write an int to memory via pointer
   ? *pMem                    // prints 9876
   free( pMem )               // free allocation
   endproc

   proc main
   Test_inttosegoff()
   endproc