1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
.TH LIBSIMPLE_ALIGNED_STRNDUP 3 libsimple
.SH NAME
libsimple_aligned_strndup, libsimple_aligned_strndupa \- duplicate a string
.SH SYNOPSIS
.nf
#include <libsimple.h>
char *libsimple_aligned_strndupa(const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
char *libsimple_aligned_strndup(const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
char *libsimple_enaligned_strndup(int \fIstatus\fP, const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
inline char *libsimple_ealigned_strndup(const char *\fIs\fP, size_t \fIalignment\fP, size_t \fIn\fP);
#ifndef aligned_strndupa
# define aligned_strndupa libsimple_aligned_strndupa
#endif
#ifndef aligned_strndup
# define aligned_strndup libsimple_aligned_strndup
#endif
#ifndef enaligned_strndup
# define enaligned_strndup libsimple_enaligned_strndup
#endif
#ifndef ealigned_strndup
# define ealigned_strndup libsimple_ealigned_strndup
#endif
.fi
.PP
Link with
.IR \-lsimple .
.SH DESCRIPTION
The
.BR libsimple_aligned_strndup ()
function allocates memory with the alignment
specified in the
.I alignment
parameter and copies the string
.I s
into the new allocation, up to the
.IR n th
byte. A NUL byte will always be written
to the end of the new string.
.PP
The
.BR libsimple_enaligned_strndup ()
and
.BR libsimple_ealigned_strndup ()
functions are versions of the
.BR libsimple_aligned_strndup ()
function that call the
.BR libsimple_enprintf (3)
function on failure, causing the process to print
an error message and exit. See
.BR libsimple_enprintf (3)
for more information.
.PP
The
.BR libsimple_strndupa ()
function is implemented as a macro and is a version
of the
.BR libsimple_strndup ()
function that uses allocates the memory on the stack
rather than on the heap, causing the return pointer
to become invalid when the calling function returns.
It is only available when compling with GCC or Clang.
.SH RETURN VALUE
Upon successful completion, the
.BR libsimple_aligned_strndupa (),
.BR libsimple_aligned_strndup (),
.BR libsimple_enaligned_strndup (),
and
.BR libsimple_ealigned_strndup ()
functions return a non-null pointer, on failure the
.BR libsimple_aligned_strndup ()
function returns
.B NULL
and set
.I errno
to indicate the error, and the
.BR libsimple_enaligned_strndup (),
and
.BR libsimple_ealigned_strndup ()
functions exit the process. The
.BR libsimple_aligned_strndupa ()
function cannot fail, however the kernel
can kill the thread, and possibly the process, with a
.B SIGSEGV
signal if the memory cannot be allocated.
.PP
The returned pointer should be deallocated when it
is no longer needed, except for the pointer returned
by the
.BR libsimple_aligned_strndupa ()
function, it is automatically deallocated when the
calling function returns.
.SH ERRORS
The
.BR libsimple_aligned_strndup ()
function may fail for any reason specified for the
.BR aligned_alloc (3)
function.
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
.TS
allbox;
lb lb lb
l l l.
Interface Attribute Value
T{
.BR libsimple_aligned_strndupa (),
.br
.BR libsimple_aligned_strndup (),
.br
.BR libsimple_enaligned_strndup (),
.br
.BR libsimple_ealigned_strndup (),
T} Thread safety MT-Safe
T{
.BR libsimple_aligned_strndupa (),
.br
.BR libsimple_aligned_strndup (),
.br
.BR libsimple_enaligned_strndup (),
.br
.BR libsimple_ealigned_strndup (),
T} Async-signal safety AS-Safe
T{
.BR libsimple_aligned_strndupa (),
.br
.BR libsimple_aligned_strndup (),
.br
.BR libsimple_enaligned_strndup (),
.br
.BR libsimple_ealigned_strndup (),
T} Async-cancel safety AC-Safe
.TE
.SH EXAMPLES
None.
.SH APPLICATION USAGE
None.
.SH RATIONALE
None.
.SH FUTURE DIRECTIONS
None.
.SH NOTES
None.
.SH HISTORY
libsimple 1.2
.SH BUGS
None.
.SH SEE ALSO
.BR libsimple_aligned_strdup (3),
.BR libsimple_aligned_memdup (3),
.BR libsimple_aligned_wcsdup (3),
.BR libsimple_aligned_wcsndup (3),
.BR libsimple_aligned_wmemdup (3),
.BR strndup (3)
|
