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

See also:

memccpy(), memcpy()