[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , Volume 2


wmemmove Subroutine

Purpose

Copy wide-characters in memory with overlapping areas.

Library

Standard library (libc.a)

Syntax

#include <wchar.h>

wchar_t *wmemmove (wchar_t * ws1, const wchar_t * ws2, size_t n) ;

Description

The wmemmove function copies n wide-characters from the object pointed to by ws2 to the object pointed to by ws1. Copying takes place as if the n wide-characters from the object pointed to by ws2 are first copied into a temporary array of n wide-characters that does not overlap the objects pointed to by ws1 or ws2, and then the n wide-characters from the temporary array are copied into the object pointed to by ws1.

This function is not affected by locale and all wchar_t values are treated identically. The null wide-character and wchar_t values not corresponding to valid characters are not treated specially.

If n is zero, ws1 and ws2 must be a valid pointers, and the function copies zero wide-characters.

Return Values

The wmemmove function returns the value of ws1.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) subroutine.

Related Information

The wmemchr (wmemchr Subroutine) subroutine, wmemcmp (wmemcmp Subroutine) subroutine, wmemcpy (wmemcpy Subroutine) subroutine, wmemset (wmemset Subroutine) subroutine.

The wchar.h file.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]