#include <stdlib.h> size_t wcstombs(char *dest, const wchar_t *src, size_t n);
1. Un caractère large que l'on ne peut pas représenter par une séquence multi-octets (dans la localisation en cours) a été rencontré. Dans ce cas la fonction renverra (size_t) -1.
2. La limite de longueur force l'arrêt. Dans ce cas, le nombre d'octets écrits dans dest est renvoyé, mais l'état de décalage est perdu.
3. La chaîne de caractères larges a été complètement convertie, y compris le Laq\0aq final. Dans ce cas la conversion se termine dans l'état initial. La fonction renvoie le nombre d'octets écrits dans dest, sans compter l'octet « \0 ».
Le programmeur doit s'assurer qu'il y a assez de place pour au moins n octets dans dest.
Si dest est NULL, la longueur n est ignorée, et la conversion se déroule comme précédemment, sauf que les octets convertis ne sont pas écrits en mémoire, et qu'il n'y a pas de limite de longueur en destination.
Pour éviter le cas 2 ci-dessus, le programmeur doit s'assurer que n est supérieur ou égal à wcstombs(NULL,src,0)+1.
La fonction wcsrtombs(3) fournit une interface sûre en contexte multithreads pour la même fonctionnalité.
Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 11 décembre 1996 et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 wcstombs ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Dernière mise à jour : 17 juillet 2008