RAD Studio |  |

strncat

Header File

string.h, mbstring.h

Category

Memory and String Manipulation Routines, Inline Routines

Prototype

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

Description

Appends a portion of one string to another.

strncat copies at most maxlen characters of src to the end of dest and then appends a null character. The maximum length of the resulting string is strlen(dest) + maxlen.

For _mbsnbcat, if the second byte of 2-bytes character is null, the first byte of this character is regarded as null.

These four functions behave identically and differ only with respect to the type of arguments and return types.

Return Value

strncat returns dest.

Example

Copy Code

    #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;
    }

Portability

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

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!