GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
WCSTOMBS(3) FreeBSD Library Functions Manual WCSTOMBS(3)

wcstombs
convert a wide-character string to a character string

Standard C Library (libc, -lc)

#include <stdlib.h>

size_t
wcstombs(char * restrict mbstring, const wchar_t * restrict wcstring, size_t nbytes);

The wcstombs() function converts a wide character string wcstring into a multibyte character string, mbstring, beginning in the initial conversion state. Up to nbytes bytes are stored in mbstring. Partial multibyte characters at the end of the string are not stored. The multibyte character string is null terminated if there is room.

The wcstombs() function returns the number of bytes converted (not including any terminating null), if successful, otherwise it returns (size_t)-1.

The wcstombs() function will fail if:
[]
An invalid wide character was encountered.
[]
The conversion state is invalid.

mbstowcs(3), multibyte(3), wcsrtombs(3), wctomb(3)

The wcstombs() function conforms to ISO/IEC 9899:1999 (“ISO C99”).
April 8, 2004 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.