blob: ed6fdca7b115ece8e24468f37c0cd5aba1276d0b (
plain) (
blame)
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
|
.TH LIBNORMALFORM_NOT 3 LIBNORMALFORM
.SH NAME
libnormalform_not \- Negation
.SH SYNOPSIS
.nf
#include <libnormalform.h>
LIBNORMALFORM_SENTENCE *libnormalform_not(LIBNORMALFORM_SENTENCE *\fIx\fP);
.fi
.PP
Link with
.IR -lnormalform .
.SH DESCRIPTION
The
.BR libnormalform_not ()
function creates a sentence whose value is
always the inverse of the value the sentence
.I x
takes.
.PP
The returned pointer shall either be
deallocated with the
.BR libnormalform_free (3)
function or be relinquished by being
used as part of another sentence.
.PP
The
.BR libnormalform_not ()
function adopt the ownership of
.IR x .
Therefore, the user shall not attempt to
deallocate
.IR x .
This holds even on failure: if the function
fails,
.I x
is deallocated.
.SH RETURN VALUE
Upon successful completion, the
.BR libnormalform_not ()
function returns an object representing
the sentence; otherwise, the function returns
.I NULL
and sets
.I errno
to indicate the error.
.SH ERRORS
The
.BR libnormalform_not ()
function fails if:
.TP
.B ENOMEM
Insufficient memory was available to
create the sentence object.
.PP
The
.BR libnormalform_not ()
function also fails without setting
.I errno
if
.I x
is
.IR NULL .
.SH ATTRIBUTES
For an explanation of the terms used in this
section, see
.BR attributes (7)
and
.IR "info \(dq(libc)POSIX Safety Concepts\(dq" .
.TS
allbox;
lb lb lb
l l l.
Interface Attribute Value
T{
.BR libnormalform_not ()
T} Thread safety MT-Safe race:\fIx\fP
T{
.BR libnormalform_not ()
T} Async-signal safety AS-Unsafe heap
T{
.BR libnormalform_not ()
T} Async-cancel safety AC-Safe mem, AC-Unsafe heap
.TE
.SH SEE ALSO
.BR libnormalform (7)
|
