_mbccpy, _mbccpy_l

Article
12/18/2017

The latest version of this topic can be found at _mbccpy, _mbccpy_l.

Copies a multibyte character from one string to another string. More secure versions of these functions are available; see _mbccpy_s, _mbccpy_s_l.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.

Syntax

void _mbccpy(  
   unsigned char *dest,  
   const unsigned char *src   
);  
void _mbccpy_l(  
   unsigned char *dest,  
   const unsigned char *src,  
   _locale_t locale  
);

Parameters

dest
Copy destination.

src
Multibyte character to copy.

locale
Locale to use.

Remarks

The _mbccpy function copies one multibyte character from src to dest.

This function validates its parameters. If _mbccpy is passed a null pointer for dest or src, the invalid parameter handler is invoked, as described in Parameter Validation. If execution is allowed to continue, errno is set to EINVAL.

_mbccpy uses the current locale for any locale-dependent behavior. _mbccpy_l is identical to _mbccpy except that _mbccpy_l uses the locale passed in for any locale-dependent behavior. For more information, see Locale.

Security Note Use a null-terminated string. The null-terminated string must not exceed the size of the destination buffer. For more information, see Avoiding Buffer Overruns. Buffer overrun problems are a frequent method of system attack, resulting in an unwarranted elevation of privilege.

Generic-Text Routine Mappings

Tchar.h routine	_UNICODE and _MBCS not defined	_MBCS defined	_UNICODE defined
`_tccpy`	Maps to macro or inline function	`_mbccpy`	Maps to macro or inline function
`_tccpy_l`	n/a	`_mbccpy_l`	n/a

Requirements

Routine	Required header
`_mbccpy`	<mbctype.h>
`_mbccpy_l`	<mbctype.h>

For more compatibility information, see Compatibility.

NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Share via