From a793e017e5d14abd28da89dbb8eb7c1919c4f997 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Tue, 20 Jan 2026 22:40:07 +0100 Subject: Add libj2_not_j2u.3 and libj2_j2i_xor_sign.3 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- libj2_j2i_xor_sign.3 | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 libj2_j2i_xor_sign.3 (limited to 'libj2_j2i_xor_sign.3') diff --git a/libj2_j2i_xor_sign.3 b/libj2_j2i_xor_sign.3 new file mode 100644 index 0000000..0290d87 --- /dev/null +++ b/libj2_j2i_xor_sign.3 @@ -0,0 +1,55 @@ +.TH LIBJ2_J2I_XOR_SIGN 3 LIBJ2 +.SH NAME +libj2_j2i_xor_sign \- Calculate bitwise NOT iff sign-bit is set + +.SH SYNOPSIS +.nf +#include + +void \fBlibj2_j2i_xor_sign\fP(struct libj2_j2i *\fIa\fP); +void \fBlibj2_j2i_xor_sign_to_j2i\fP(const struct libj2_j2i *\fIa\fP, struct libj2_j2i *\fIr\fP); +void \fBlibj2_j2i_xor_sign_to_j2u\fP(const struct libj2_j2i *\fIa\fP, struct libj2_j2u *\fIr\fP); +.fi +.PP +Link with +.IR -lj2 . + +.SH DESCRIPTION +The above listed functions calculate +the bitwise inverse (NOT) of +.I a +if the sign-bit is set in +.IR a , +that is, if and only if +.I a +is negative: for each bit, the XOR with +the sign-bit is calculated. The result, +which is always non-negative, is stored in +.IR r , +except in the case of the +.BR libj2_j2i_xor_sign () +function, where the result is stored in +.IR a . +.PP +The arguments are assumed to be +.RI non- NULL . + +.SH RETURN VALUE +None. + +.SH ERRORS +The above listed functions cannot fail. + +.SH HISTORY +The +.BR libj2_j2i_xor_sign (), +.BR libj2_j2i_xor_sign_to_j2i (), +and +.BR libj2_j2i_xor_sign_to_j2u () +functions were added in version 1.1 of +.BR libj2 . + +.SH SEE ALSO +.BR libj2 (7), +.BR libj2_j2u_not (3), +.BR libj2_j2i_is_negative (3) -- cgit v1.2.3-70-g09d2