Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

wcstombs - Langzeichen in Multibyte-Zeichenkette umwandeln

&pagelevel(4)&pagelevel

Definition

#include <stdlib.h>

size_t wcstombs(char *s, const wchar_t *pwcs, size_t n);

wcstombs wandelt eine Folge von Langzeichen (wchar_t-Werten) in pwcs in die entsprechenden Multibyte-Zeichen um und speichert diese in die Zeichenkette s.
n gibt die maximale Anzahl Bytes an, die in s abgespeichert werden sollen.

Die Zuweisung wird beendet, wenn

  • das Langzeichen 0 in pwcs auftritt,

  • bereits n Bytes zugewiesen wurden oder

  • ein Langzeichen nicht in einem Byte dargestellt werden kann.

Returnwert

Anzahl der zugewiesenen Bytes

 


bei Erfolg.


(size_t)-1

wenn ein Langzeichen nicht in ein Multibyte-Zeichen umgewandelt werden kann.              

Hinweise

Wenn ein Langzeichen in pwcs nicht in ein Multibyte-Zeichen umgewandelt werden kann, werden die bereits vorher umgewandelten Langzeichen in s abgespeichert.

Bei sich überlappenden Speicherbereichen ist das Verhalten undefiniert.

In dieser Implementierung sind Zeichen, die aus mehreren Bytes bestehen, nicht realisiert.
Multibyte-Zeichen und Langzeichen haben immer die Länge 1 Byte. Mit wcstombs wird jedes Langzeichen in pwcs in ein1 Byte langes Multibyte-Zeichen umgewandelt und in der Zeichenkette s gespeichert.

Siehe auch

mblen, mbtowc, mbstowcs, wctomb