# C 语言标准库函数 imaxdiv

/*********************************************
 * @brief 计算除法，同时得到商和余数
 * @param x 被除数
 * @param y 除数
 * @return 包含商和余数的结构体
 ********************************************/
imaxdiv_t imaxdiv(intmax_t x, intmax_t y);

!subtitle:说明

计算 intmax_t 类型的除法，同时得到商和余数，其中商向零取整。

!subtitle:参数

• x - 被除数

• y - 除数

!subtitle:返回值

包含商和余数的结构体。

结构体定义可能为（字段顺序未定义）：

struct imaxdiv_t {
    intmax_t quot;   // 商
    intmax_t rem;    // 余数
};

或

struct imaxdiv_t {
    intmax_t rem;    // 余数
    intmax_t quot;   // 商
};

# 示例

#include <stdio.h>
#include <inttypes.h>

int main(void)
{
    imaxdiv_t result = imaxdiv(10, 3);  // 得 3 余 1
    printf("imaxdiv(10, 3) = %" PRIdMAX " ... %" PRIdMAX"\n", result.quot, result.rem);

    result = imaxdiv(-10, 3);  // 得 -3 余 -1
    printf("imaxdiv(-10, 3) = %" PRIdMAX " ... %" PRIdMAX"\n", result.quot, result.rem);
    
    return 0;
}

运行结果：

imaxdiv(10, 3) = 3 ... 1
imaxdiv(-10, 3) = -3 ... -1

# 推荐阅读

• C 语言标准库函数 div

• C 语言标准库函数 ldiv

• C 语言标准库函数 lldiv

• imaxdiv - cppreference

# 参考标准

• C23 standard (ISO/IEC 9899:2024):

  • 7.8.2.2 The imaxdiv function (p: TBD)

  • 7.22.6.2 The div, ldiv and lldiv functions (p: TBD)

• C17 standard (ISO/IEC 9899:2018):

  • 7.8.2.2 The imaxdiv function (p: 159)

  • 7.22.6.2 The div, ldiv and lldiv functions (p: 259)

• C11 standard (ISO/IEC 9899:2011):

  • 7.8.2.2 The imaxdiv function (p: 219)

  • 7.22.6.2 The div, ldiv and lldiv functions (p: 356)

• C99 standard (ISO/IEC 9899:1999):

  • 7.8.2.2 The imaxdiv function (p: 200)

  • 7.20.6.2 The div, ldiv and lldiv functions (p: 320)