aboutsummaryrefslogtreecommitdiffstats
path: root/libj2_j2i_sub_j2i.3
diff options
context:
space:
mode:
authorMattias Andrée <m@maandree.se>2026-02-12 13:45:48 +0100
committerMattias Andrée <m@maandree.se>2026-02-12 13:45:48 +0100
commit8b1e9c4dd1fd12e3b85750a5c0044b54ced216c7 (patch)
treefbf6b79555576e9005eeb84c0b605985a27fa714 /libj2_j2i_sub_j2i.3
parentlibj2_j2i_divmod_j2i_to_j2i: test overflow edge case (diff)
downloadlibj2-1.2.tar.gz
libj2-1.2.tar.bz2
libj2-1.2.tar.xz
Add subtraction and addition with carry/borrow and add abs_diff1.2
Signed-off-by: Mattias Andrée <m@maandree.se>
Diffstat (limited to '')
-rw-r--r--libj2_j2i_sub_j2i.327
1 files changed, 27 insertions, 0 deletions
diff --git a/libj2_j2i_sub_j2i.3 b/libj2_j2i_sub_j2i.3
index c0b7a35..b49a0a2 100644
--- a/libj2_j2i_sub_j2i.3
+++ b/libj2_j2i_sub_j2i.3
@@ -23,6 +23,9 @@ int \fBlibj2_j2i_sub_j2i_overflow_p\fP(const struct libj2_j2i *\fIa\fP, const st
int \fBlibj2_j2i_sub_ji_overflow_p\fP(const struct libj2_j2i *\fIa\fP, intmax_t \fIb\fP);
int \fBlibj2_ji_sub_j2i_overflow_p\fP(intmax_t \fIa\fP, const struct libj2_j2i *\fIb\fP);
+void \fBlibj2_j2i_sub_j2i_carry\fP(struct libj2_j2i *\fIa\fP, const struct libj2_j2i *\fIb\fP, int *\fIc\fP);
+void \fBlibj2_j2i_sub_j2i_to_j2i_carry\fP(const struct libj2_j2i *\fIa\fP, const struct libj2_j2i *\fIb\fP, struct libj2_j2i *\fIr\fP, int *\fIc\fP);
+
void \fBlibj2_j2i_rsub_j2i\fP(struct libj2_j2i *\fIb\fP, const struct libj2_j2i *\fIa\fP);
void \fBlibj2_j2i_rsub_ji\fP(struct libj2_j2i *\fIb\fP, intmax_t \fIa\fP);
@@ -32,6 +35,8 @@ int \fBlibj2_j2i_rsub_ji_overflow\fP(struct libj2_j2i *\fIb\fP, intmax_t \fIa\fP
int \fBlibj2_j2i_rsub_j2i_overflow_p\fP(const struct libj2_j2i *\fIb\fP, const struct libj2_j2i *\fIa\fP);
int \fBlibj2_j2i_rsub_ji_overflow_p\fP(const struct libj2_j2i *\fIb\fP, intmax_t \fIa\fP);
+void \fBlibj2_j2i_rsub_j2i_carry\fP(struct libj2_j2i *\fIb\fP, const struct libj2_j2i *\fIa\fP, int *\fIc\fP);
+
void \fBlibj2_j2i_sat_sub_j2i\fP(struct libj2_j2i *\fIa\fP, const struct libj2_j2i *\fIb\fP);
void \fBlibj2_j2i_sat_sub_j2i_to_j2i\fP(const struct libj2_j2i *\fIa\fP, const struct libj2_j2i *\fIb\fP, struct libj2_j2i *\fIr\fP);
void \fBlibj2_j2i_sat_sub_ji\fP(struct libj2_j2i *\fIa\fP, intmax_t \fIb\fP);
@@ -84,6 +89,19 @@ with word
.B overflow
in their name), detect arithmetic overflow.
.PP
+The
+.BR libj2_j2i_sub_j2i_carry (),
+.BR libj2_j2i_sub_j2i_to_j2i_carry (),
+and
+.BR libj2_j2i_rsub_j2i_carry ()
+functions add
+.IR *c ,
+which must be +1, -1, or 0,
+to the result, and sets
+.I *c
+to +1 on positive overflow,
+-1 on negative overflow, and 0 otherwise.
+.PP
The result is truncated to the least significant
bits, as many as can be stored, in case of overflow;
that is, modular arithmetics is used. However, the
@@ -139,10 +157,19 @@ and
.BR libj2_j2i_sat_rsub_ji ()
functions were added in version 1.1 of
.BR libj2 .
+.PP
+The
+.BR libj2_j2i_sub_j2i_carry (),
+.BR libj2_j2i_sub_j2i_to_j2i_carry (),
+and
+.BR libj2_j2i_rsub_j2i_carry ()
+functions were added in version 1.2 of
+.BR libj2 .
.SH SEE ALSO
.BR libj2 (7),
.BR libj2_j2u_sub_j2u (3),
+.BR libj2_j2u_abs_diff_j2u (3),
.BR libj2_j2i_add_j2i (3),
.BR libj2_j2i_mul_j2i (3),
.BR libj2_j2i_divmod_j2i (3)