_mbsnbcpy
Nach oben zu String.h - Index
Header-Datei
mbstring.h
Kategorie
Routinen für Speicher- und String-Bearbeitung
Prototyp
unsigned char *_mbsnbcpy(unsigned char *dest, unsigned char *src, size_t maxlen);
Beschreibung
Die Funktion _mbsnbcpy kopiert maximal maxlen Bytes aus dem Puffer src in den Puffer dest. Der Puffer dest ist nach dem Kopiervorgang nullterminiert.
Der Benutzer ist dafür verantwortlich, dass der Puffer dest für den Kopiervorgang groß genug ist. Eine nicht ausreichende Puffergröße kann zu Speicherfehlern führen.
Rückgabewert
Die Funktion gibt dest zurück.
Beispiel
#include <mbstring.h>
/* Erstellt eine Kopie des MBCS-Strings */
char* dupe_mb_string(char* str)
{
/* Länge des Eingabe-Strings ermitteln */
int str_len = strlen(str);
/* Bei leerem String nichts ausführen */
if (!str || !str_len)
return NULL;
/* Ausreichenden Speicher für den neuen String zuweisen und die Kopierroutine aufrufen */
return _mbsnbcpy((char*)malloc(str_len + 1), str, str_len);
}