.\" Copyright 2026 Andrew V.Kosteltsev (kx@radix-linux.su)
.\"
.\"
.TH imul_mod 3  "September 14, 2026" "libmpu" "LibMPU Programmer's Manual"
.SH NAME
\fBimul_mod\fP \- модульное умножение беззнаковых целых чисел
.SH SYNOPSIS
.nf
.B #include <libmpu.h>
.PP
.BI "void imul_mod( mpu_int *" c ", mpu_int *" a ", mpu_int *" b ", mpu_int *" m ", int " nb " );"
.fi
.SH DESCRIPTION
Функция \fBimul_mod()\fP выполняет операцию модульного умножения
.sp
.nf
        c = (a * b) mod m
.fi
.sp
и размещает результат по адресу \fBc\fP. Произведение вычисляется с достаточной
промежуточной разрядностью, поэтому до выполнения модульного приведения оно не усекается
до \fBnb\fP байтов. Содержимое памяти по адресам \fBa\fP, \fBb\fP и \fBm\fP не изменяется.
Параметр \fBnb\fP определяет размер всех операндов в байтах.
.PP
Если \fBm\fP равно нулю, значение по адресу \fBc\fP не изменяется, выставляется флаг
\fBV\fP (Invalid operation), а переменной \fB__mpu_integer_error_no\fP присваивается
значение \fB__I_ENUMBER__\fP.
.PP
При успешном завершении флаг \fBZ\fP выставляется, если результат модульного умножения
равен нулю.
.sp
.SH EXAMPLES
.nf
.sp
#include <libmpu.h>
#include <stdio.h>

int main( void )
{
  mpu_int1024_t  c, a, b, m;
  int            nb = NB_I1024;
  __mpu_char8_t  s[4096];

  __mpu_init();

  iatoui( a, "200", nb );
  iatoui( b, "201", nb );
  iatoui( m, "251", nb );

  imul_mod( c, a, b, m, nb );
  iuitoa( s, c, RADIX_DEC, LOWERCASE, nb );
  printf( "c = %s;\\n", s ); /* c = 40; */

  __mpu_free_context();

  return( 0 );
}
.fi
.sp
.SH SEE ALSO
.BR iadd(3),
.BR isub(3),
.BR iadc(3),
.BR isbb(3),
.BR ineg(3),
.BR inot(3),
.BR iand(3),
.BR itest(3),
.BR icmp(3),
.BR ior(3),
.BR ixor(3),
.BR iinc(3),
.BR idec(3),
.BR ixchg(3),
.BR icpy(3),
.BR icvt(3),
.BR imul(3),
.BR ismul(3),
.BR idiv(3),
.BR isdiv(3),
.BR iatoi(3),
.BR iatoui(3),
.BR iitoa(3),
.BR iuitoa(3),
.BR _int_digs(3),
.BR ibits_len(3),
.BR igcd(3),
.BR ilcm(3),
.BR imod(3),
.BR ipow_mod(3),
.BR ipowm1_mod(3),
.BR shifts(3),
.BR shifts\-n(3),
.BR circular\-shifts(3),
.BR circular\-shifts\-n(3),
.BR integer\-flags(3),
.BR real\-flags(3),
.BR libmpu(7).