[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

memcpyv()

Copy a given number of structures

Synopsis:

#include <string.h>

size_t memcpyv( const struct iovec *dst,
                int dparts,
                int doff,
                const struct iovec *src,
                int sparts,
                int soff );

Arguments:

dst
An array of iovec structures that you want to copy the data to.
dparts
The number of entries in the dst array.
doff
The offset into the dst array at which to start copying.
src
An array of iovec structures that you want to copy the data from.
sparts
The number of entries in the src array.
soff
The offset into the src array at which to start copying.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The function memcpyv() copies data pointed to by the src I/O vector, starting at offset soff, to dst structures, starting at offset doff. The number of I/O vector parts copied is specified in sparts and dparts.

Returns:

The number of bytes copied.

Examples:

#include <stdio.h>
#include <string.h>
#include <stdlib.h>

int main( void )
{
    const struct iovec *dest, *source;
    int dparts, doffset, sparts, soffset;
    size_t nbytes;

    nbytes = memcpyv ( dest, dparts, doffset,
                       source, sparts, soffset );
    printf ( "The number of bytes copied is %d. \n", nbytes );

    return EXIT_SUCCESS;
}

Classification:

QNX 4

Safety:
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

See also:

memccpy(), memcpy()


[Previous] [Contents] [Index] [Next]