X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=man3%2Fstrdup.3;h=61acee56bcea79d3ec19286d9c68b06ef07110dd;hp=28036115251d13c7a1c65d912fa84bac0107da61;hb=abc15df6b9fae3374d24c7cf5c3ab94c605b2a6d;hpb=8894c921674bb116d0a7b8f23a55311e7a768019 diff --git a/man3/strdup.3 b/man3/strdup.3 index 2803611..61acee5 100644 --- a/man3/strdup.3 +++ b/man3/strdup.3 @@ -1,59 +1,59 @@ -.\" This file is part of the Public Domain C Library (PDCLib). -.\" Permission is granted to use, modify, and / or redistribute at will. -.\" -.Dd -.Dt strdup 3 -.Os -.\" -.Sh NAME -.Nm strdup -.Nd string duplication -.\" -.Sh SYNOPSIS -.Sy #define _XOPEN_SOURCE || _POSIX_C_SOURCE >= 200809L -.In string.h -.Fn "char *strdup" "const char *str" -.Pp -.Sy #define _POSIX_C_SOURCE >= 200809L -.In string.h -.Fn "char *strndup" "const char *str" "size_t len" -.\" -.Sh DESCRIPTION -.Fn strdup -allocates a new buffer of sufficient size as to be able to hold the entirety of -.Va str , -including the terminating character, and copies the contents of -.Va str -into it. -.\" -.Pp -.Fn strndup -allocates a buffer large enough to contain -.Va len -characters, plus a trailing null character, or sufficient to contain the -entirety of -.Va str -including the trailing null character, whichever is smaller. The first -.Va len -characters of -.Va str -are then copied into it, and a null character appended. -.\" -.Pp -The buffers returned by these functions must be released by a call to -.Fn free . -.\" -.Sh SEE ALSO -.Xr free 3 -.Xr malloc 3 -.Xr strcpy 3 -.Xr strncpy 3 -.\" -.Sh STANDARDS -.Fn strdup -first specified in -.St -xpg3 . -Moved into POSIX, and -.Fn strndup -added, with +.\" This file is part of the Public Domain C Library (PDCLib). +.\" Permission is granted to use, modify, and / or redistribute at will. +.\" +.Dd +.Dt strdup 3 +.Os +.\" +.Sh NAME +.Nm strdup +.Nd string duplication +.\" +.Sh SYNOPSIS +.Sy #define _XOPEN_SOURCE || _POSIX_C_SOURCE >= 200809L +.In string.h +.Fn "char *strdup" "const char *str" +.Pp +.Sy #define _POSIX_C_SOURCE >= 200809L +.In string.h +.Fn "char *strndup" "const char *str" "size_t len" +.\" +.Sh DESCRIPTION +.Fn strdup +allocates a new buffer of sufficient size as to be able to hold the entirety of +.Va str , +including the terminating character, and copies the contents of +.Va str +into it. +.\" +.Pp +.Fn strndup +allocates a buffer large enough to contain +.Va len +characters, plus a trailing null character, or sufficient to contain the +entirety of +.Va str +including the trailing null character, whichever is smaller. The first +.Va len +characters of +.Va str +are then copied into it, and a null character appended. +.\" +.Pp +The buffers returned by these functions must be released by a call to +.Fn free . +.\" +.Sh SEE ALSO +.Xr free 3 +.Xr malloc 3 +.Xr strcpy 3 +.Xr strncpy 3 +.\" +.Sh STANDARDS +.Fn strdup +first specified in +.St -xpg3 . +Moved into POSIX, and +.Fn strndup +added, with .St -p1003.1-2008 . \ No newline at end of file