strncat

Nach oben zu String.h - Index

Header-Datei

string.h, mbstring.h

Kategorie

Routinen für Speicher- und String-Bearbeitung, Inline-Routinen

Prototyp

char *strncat(char *dest, const char *src, size_t maxlen);

wchar_t *wcsncat(wchar_t *dest, const wchar_t *src, size_t maxlen);

unsigned char *_mbsncat(unsigned char *dest, const unsigned char *src, size_t maxlen);

unsigned char *_mbsnbcat(unsigned char *__dest, const unsigned char *__src, _SIZE_T __maxlen);

Beschreibung

Hängt einen Teil eines Strings an einen anderen an.

strncat kopiert maximal maxlen Zeichen von src an das Ende von dest und hängt dann ein Nullzeichen an. Die Maximallänge des Ergebnis-Strings ist strlen(dest) + maxlen.

Die ersten drei Funktionen verhalten sich identisch und unterscheiden sich nur durch den Typ ihrer Argumente und ihrer Rückgabewerte.

Ist das zweite Byte eines Multibyte-Zeichens Null, betrachtet _mbsnbcat auch das erste Byte dieses Zeichens als Null. _mbsnbcat kopiert auch maximal maxlen Bytes, aber keine Zeichen wie die anderen Funktionen.

Rückgabewert

strncat gibt dest zurück.

Beispiel

#include <string.h>
#include <stdio.h>
int main(void)
{
  char destination[25];
  char *source = " States";
  strcpy(destination, "United");
  strncat(destination, source, 7);
  printf("%s\n", destination);
  return 0;
}

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
strncat	+	+	+	+
_mbsncat		+
_mbsnbcat		+
_wcsncat		+