_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);
 }