_movedata

Description

Moves characters to another segment.

void _movedata( unsigned int srcseg, unsigned int srcoff, unsigned int destseg,
unsigned int destoff, unsigned int count );

Remarks

The _movedata function copies count bytes from the source address specified by srcseg:srcoff to the destination address specified by destseg:destoff.

The _movedata function was intended to move far data in small-model programs. The newer model-independent _fmemcpy and _fmemmove functions should be used instead of the _movedata function. In large-model programs, the memcpy and memmove functions can also be used.

Segment values for the srcseg and destseg arguments can be obtained by using either the _segread function or the _FP_SEG macro.

The _movedata function does not handle all cases of overlapping moves correctly. These occur when part of the destination is the same memory area as part of the source. The memmove function correctly handles overlapping moves.

Return Value

None.

Compatibility

Standards:None

16-Bit:DOS, QWIN, WIN, WIN DLL

32-Bit:None

See Also

_FP_OFF, _FP_SEG, memcpy, memmove, _segread

Example

/* MOVEDATA.C */

#include <memory.h>

#include <stdio.h>

#include <string.h>

#include <dos.h>

#include <malloc.h>

char __far *src = "This is a test.";

void main( void )

{

char __far *dest;

if( (dest = _fmalloc( 80 )) != NULL )

{

_movedata( _FP_SEG( src ), _FP_OFF( src ),

_FP_SEG( dest ), _FP_OFF( dest ), _fstrlen( src ) + 1 );

printf( "The source data at %Fp is '%Fs'\n", src, src );

printf( "The destination data at %Fp is '%Fs'\n", dest, dest );

_ffree( dest );

}

}

Output

The source data at 2D0A:02B8 is 'This is a test.'

The destination data at 3D0B:0016 is 'This is a test.'