XU XUv0.8.8
EN

API

#math/big

import: #math/big

counts: 3 函数, 58 方法, 3 类型, 5 常量, 0 方法集

大整数 Int 与有理数 Rat。无 Float。

struct Int

XuAPI
pub struct Int {
    pub neg bool
    pub abs []int
}

用途

公开结构体 `Int`。

参数

neg bool
字段（bool）
abs []int
字段（[]int）

new_int

XuAPI
pub fn new_int(x int) Int

用途

构造 int。

参数

x int
值（int）

返回

Int — 该类型的值

(&mut Int) set_int64

XuAPI
pub fn (z &mut Int) set_int64(x int)

用途

`&mut Int` 上的方法：设置 int64。

参数

z &mut Int
接收者 &mut Int（可变借用）
x int
值（int）

(&mut Int) set

XuAPI
pub fn (z &mut Int) set(x &Int)

用途

在 `&mut Int` 上调用 `set`。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）

(&mut Int) set_bytes

XuAPI
pub fn (z &mut Int) set_bytes(buf string)

用途

`&mut Int` 上的方法：设置 bytes。

参数

z &mut Int
接收者 &mut Int（可变借用）
buf string
缓冲（string）

(&mut Int) set_string

XuAPI
pub fn (z &mut Int) set_string(s string, base0 int) int

用途

`&mut Int` 上的方法：设置 string。失败时 throw。

参数

z &mut Int
接收者 &mut Int（可变借用）
s string
源字符串（string）
base0 int
base0（int）

返回

int — 该类型的值

(&Int) sign

XuAPI
pub fn (z &Int) sign() int

用途

`&Int` 上的方法：签名。

参数

z &Int
接收者 &Int（借用）

返回

int — 该类型的值

(&Int) cmp

XuAPI
pub fn (z &Int) cmp(y &Int) int

用途

在 `&Int` 上调用 `cmp`。

参数

z &Int
接收者 &Int（借用）
y &Int
值（借用，调用方仍持有；类型 &Int）

返回

int — 该类型的值

(&Int) bit_len

XuAPI
pub fn (z &Int) bit_len() int

用途

`&Int` 上的方法：bit长度。

参数

z &Int
接收者 &Int（借用）

返回

int — 该类型的值

(&Int) bit

XuAPI
pub fn (z &Int) bit(i int) int

用途

在 `&Int` 上调用 `bit`。

参数

z &Int
接收者 &Int（借用）
i int
下标或整数（int）

返回

int — 该类型的值

(&Int) bytes

XuAPI
pub fn (z &Int) bytes() string

用途

`&Int` 上的方法：返回已缓冲的字节串。

参数

z &Int
接收者 &Int（借用）

返回

string — 结果字符串

(&Int) text

XuAPI
pub fn (z &Int) text() string

用途

`&Int` 上的方法：返回当前文本。

参数

z &Int
接收者 &Int（借用）

返回

string — 结果字符串

(&Int) int64

XuAPI
pub fn (z &Int) int64() int

用途

在 `&Int` 上调用 `int64`。

参数

z &Int
接收者 &Int（借用）

返回

int — 该类型的值

(&mut Int) add

XuAPI
pub fn (z &mut Int) add(x &Int, y &Int)

用途

`&mut Int` 上的方法：相加。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
y &Int
值（借用，调用方仍持有；类型 &Int）

(&mut Int) sub

XuAPI
pub fn (z &mut Int) sub(x &Int, y &Int)

用途

`&mut Int` 上的方法：相减。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
y &Int
值（借用，调用方仍持有；类型 &Int）

(&mut Int) mul

XuAPI
pub fn (z &mut Int) mul(x &Int, y &Int)

用途

`&mut Int` 上的方法：相乘。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
y &Int
值（借用，调用方仍持有；类型 &Int）

(&mut Int) neg

XuAPI
pub fn (z &mut Int) neg(x &Int)

用途

在 `&mut Int` 上调用 `neg`。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）

(&mut Int) abs

XuAPI
pub fn (z &mut Int) abs(x &Int)

用途

`&mut Int` 上的方法：绝对值。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）

(&mut Int) lsh

XuAPI
pub fn (z &mut Int) lsh(x &Int, n int)

用途

在 `&mut Int` 上调用 `lsh`。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
n int
数量、长度或上限（int）

(&mut Int) rsh

XuAPI
pub fn (z &mut Int) rsh(x &Int, n int)

用途

在 `&mut Int` 上调用 `rsh`。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
n int
数量、长度或上限（int）

(&mut Int) quo

XuAPI
pub fn (z &mut Int) quo(x &Int, y &Int) int

用途

`&mut Int` 上的方法：商。失败时 throw。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
y &Int
值（借用，调用方仍持有；类型 &Int）

返回

int — 该类型的值

(&mut Int) rem

XuAPI
pub fn (z &mut Int) rem(x &Int, y &Int) int

用途

`&mut Int` 上的方法：余。失败时 throw。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
y &Int
值（借用，调用方仍持有；类型 &Int）

返回

int — 该类型的值

(&mut Int) mod

XuAPI
pub fn (z &mut Int) mod(x &Int, m &Int) int

用途

`&mut Int` 上的方法：取模。失败时 throw。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
m &Int
m（借用，调用方仍持有；类型 &Int）

返回

int — 该类型的值

(&mut Int) exp

XuAPI
pub fn (z &mut Int) exp(x &Int, y &Int, m &Int) int

用途

`&mut Int` 上的方法：e 的幂。失败时 throw。

参数

z &mut Int
接收者 &mut Int（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）
y &Int
值（借用，调用方仍持有；类型 &Int）
m &Int
m（借用，调用方仍持有；类型 &Int）

返回

int — 该类型的值

(&mut Int) gcd

XuAPI
pub fn (z &mut Int) gcd(a &Int, b &Int)

用途

`&mut Int` 上的方法：最大公约数。

参数

z &mut Int
接收者 &mut Int（可变借用）
a &Int
值（借用，调用方仍持有；类型 &Int）
b &Int
b（借用，调用方仍持有；类型 &Int）

(&mut Int) mod_inverse

XuAPI
pub fn (z &mut Int) mod_inverse(g &Int, n &Int) int

用途

`&mut Int` 上的方法：取模inverse。失败时 throw。

参数

z &mut Int
接收者 &mut Int（可变借用）
g &Int
g（借用，调用方仍持有；类型 &Int）
n &Int
数量、长度或上限（借用，调用方仍持有；类型 &Int）

返回

int — 该类型的值

(&Int) probably_prime

XuAPI
pub fn (x &Int) probably_prime(nchecks int) bool

用途

`&Int` 上的方法：probably素数。

参数

x &Int
接收者 &Int（借用）
nchecks int
nchecks（int）

返回

bool — 是否成立

struct Rat

XuAPI
pub struct Rat {

}

用途

公开结构体 `Rat`。

参数

无

new_rat

XuAPI
pub fn new_rat(a int, b int) Rat

用途

构造 rat。

参数

a int
值（int）
b int
b（int）

返回

Rat — 该类型的值

(&mut Rat) set_frac

XuAPI
pub fn (z &mut Rat) set_frac(a &Int, b &Int) int

用途

`&mut Rat` 上的方法：设置 frac。失败时 throw。

参数

z &mut Rat
接收者 &mut Rat（可变借用）
a &Int
值（借用，调用方仍持有；类型 &Int）
b &Int
b（借用，调用方仍持有；类型 &Int）

返回

int — 该类型的值

(&Rat) num

XuAPI
pub fn (z &Rat) num() Int

用途

`&Rat` 上的方法：分子。

参数

z &Rat
接收者 &Rat（借用）

返回

Int — 该类型的值

(&Rat) denom

XuAPI
pub fn (z &Rat) denom() Int

用途

`&Rat` 上的方法：分母。

参数

z &Rat
接收者 &Rat（借用）

返回

Int — 该类型的值

(&Rat) sign

XuAPI
pub fn (z &Rat) sign() int

用途

`&Rat` 上的方法：签名。

参数

z &Rat
接收者 &Rat（借用）

返回

int — 该类型的值

(&mut Rat) add

XuAPI
pub fn (z &mut Rat) add(x &Rat, y &Rat)

用途

`&mut Rat` 上的方法：相加。

参数

z &mut Rat
接收者 &mut Rat（可变借用）
x &Rat
值（借用，调用方仍持有；类型 &Rat）
y &Rat
值（借用，调用方仍持有；类型 &Rat）

(&mut Rat) sub

XuAPI
pub fn (z &mut Rat) sub(x &Rat, y &Rat)

用途

`&mut Rat` 上的方法：相减。

参数

z &mut Rat
接收者 &mut Rat（可变借用）
x &Rat
值（借用，调用方仍持有；类型 &Rat）
y &Rat
值（借用，调用方仍持有；类型 &Rat）

(&mut Rat) mul

XuAPI
pub fn (z &mut Rat) mul(x &Rat, y &Rat)

用途

`&mut Rat` 上的方法：相乘。

参数

z &mut Rat
接收者 &mut Rat（可变借用）
x &Rat
值（借用，调用方仍持有；类型 &Rat）
y &Rat
值（借用，调用方仍持有；类型 &Rat）

(&mut Rat) quo

XuAPI
pub fn (z &mut Rat) quo(x &Rat, y &Rat) int

用途

`&mut Rat` 上的方法：商。失败时 throw。

参数

z &mut Rat
接收者 &mut Rat（可变借用）
x &Rat
值（借用，调用方仍持有；类型 &Rat）
y &Rat
值（借用，调用方仍持有；类型 &Rat）

返回

int — 该类型的值

const to_zero

XuAPI
pub const to_zero = 0

用途

公开常量 `to_zero`。 值为 `0`

参数

无

const to_nearest_even

XuAPI
pub const to_nearest_even = 1

用途

公开常量 `to_nearest_even`。 值为 `1`

参数

无

const to_neg_inf

XuAPI
pub const to_neg_inf = 2

用途

公开常量 `to_neg_inf`。 值为 `2`

参数

无

const to_pos_inf

XuAPI
pub const to_pos_inf = 3

用途

公开常量 `to_pos_inf`。 值为 `3`

参数

无

const away_from_zero

XuAPI
pub const away_from_zero = 4

用途

公开常量 `away_from_zero`。 值为 `4`

参数

无

struct Float

XuAPI
pub struct Float {
    pub prec int
    pub neg bool
    pub mant Int
    pub exp int
    pub form int
    pub mode int
}

用途

公开结构体 `Float`。

参数

prec int
精度
neg bool
字段（bool）
mant Int
字段（Int）
exp int
字段（int）
form int
字段（int）
mode int
模式

new_float

XuAPI
pub fn new_float() Float

用途

构造 float。

参数

无

返回

Float — 该类型的值

(&mut Float) set_prec

XuAPI
pub fn (z &mut Float) set_prec(p int)

用途

`&mut Float` 上的方法：设置 prec。

参数

z &mut Float
接收者 &mut Float（可变借用）
p int
p（int）

(&Float) precision

XuAPI
pub fn (z &Float) precision() int

用途

在 `&Float` 上调用 `precision`。

参数

z &Float
接收者 &Float（借用）

返回

int — 该类型的值

(&mut Float) set_mode

XuAPI
pub fn (z &mut Float) set_mode(m int)

用途

`&mut Float` 上的方法：设置 mode。

参数

z &mut Float
接收者 &mut Float（可变借用）
m int
m（int）

(&Float) rounding

XuAPI
pub fn (z &Float) rounding() int

用途

在 `&Float` 上调用 `rounding`。

参数

z &Float
接收者 &Float（借用）

返回

int — 该类型的值

(&mut Float) set_inf

XuAPI
pub fn (z &mut Float) set_inf(neg bool)

用途

`&mut Float` 上的方法：设置 inf。

参数

z &mut Float
接收者 &mut Float（可变借用）
neg bool
neg（bool）

(&mut Float) set_nan

XuAPI
pub fn (z &mut Float) set_nan()

用途

`&mut Float` 上的方法：设置 nan。

参数

z &mut Float
接收者 &mut Float（可变借用）

(&Float) is_inf

XuAPI
pub fn (z &Float) is_inf() bool

用途

`&Float` 上的方法：是否为无穷。

参数

z &Float
接收者 &Float（借用）

返回

bool — 是否成立

(&Float) is_nan

XuAPI
pub fn (z &Float) is_nan() bool

用途

`&Float` 上的方法：是否为 NaN。

参数

z &Float
接收者 &Float（借用）

返回

bool — 是否成立

(&mut Float) set

XuAPI
pub fn (z &mut Float) set(x &Float)

用途

在 `&mut Float` 上调用 `set`。

参数

z &mut Float
接收者 &mut Float（可变借用）
x &Float
值（借用，调用方仍持有；类型 &Float）

(&mut Float) set_int64

XuAPI
pub fn (z &mut Float) set_int64(x int)

用途

`&mut Float` 上的方法：设置 int64。

参数

z &mut Float
接收者 &mut Float（可变借用）
x int
值（int）

(&mut Float) set_int

XuAPI
pub fn (z &mut Float) set_int(x &Int)

用途

`&mut Float` 上的方法：设置 int。

参数

z &mut Float
接收者 &mut Float（可变借用）
x &Int
值（借用，调用方仍持有；类型 &Int）

(&Float) to_int64

XuAPI
pub fn (z &Float) to_int64() int

用途

`&Float` 上的方法：转换为 int64。失败时 throw。

参数

z &Float
接收者 &Float（借用）

返回

int — 该类型的值

(&Float) signbit

XuAPI
pub fn (z &Float) signbit() bool

用途

`&Float` 上的方法：符号位。

参数

z &Float
接收者 &Float（借用）

返回

bool — 是否成立

(&Float) unbiased_exp

XuAPI
pub fn (z &Float) unbiased_exp() int

用途

`&Float` 上的方法：unbiased指数。

参数

z &Float
接收者 &Float（借用）

返回

int — 该类型的值

(&Float) mantissa

XuAPI
pub fn (z &Float) mantissa() Float

用途

在 `&Float` 上调用 `mantissa`。

参数

z &Float
接收者 &Float（借用）

返回

Float — 该类型的值

(&mut Float) set_mant_exp

XuAPI
pub fn (z &mut Float) set_mant_exp(mant &Float, exp int)

用途

`&mut Float` 上的方法：设置 mant exp。

参数

z &mut Float
接收者 &mut Float（可变借用）
mant &Float
mant（借用，调用方仍持有；类型 &Float）
exp int
exp（int）

(&Float) sign

XuAPI
pub fn (z &Float) sign() int

用途

`&Float` 上的方法：签名。

参数

z &Float
接收者 &Float（借用）

返回

int — 该类型的值

(&Float) cmp

XuAPI
pub fn (z &Float) cmp(y &Float) int

用途

在 `&Float` 上调用 `cmp`。失败时 throw。

参数

z &Float
接收者 &Float（借用）
y &Float
值（借用，调用方仍持有；类型 &Float）

返回

int — 该类型的值

(&mut Float) add

XuAPI
pub fn (z &mut Float) add(x &Float, y &Float)

用途

`&mut Float` 上的方法：相加。

参数

z &mut Float
接收者 &mut Float（可变借用）
x &Float
值（借用，调用方仍持有；类型 &Float）
y &Float
值（借用，调用方仍持有；类型 &Float）

(&mut Float) sub

XuAPI
pub fn (z &mut Float) sub(x &Float, y &Float)

用途

`&mut Float` 上的方法：相减。

参数

z &mut Float
接收者 &mut Float（可变借用）
x &Float
值（借用，调用方仍持有；类型 &Float）
y &Float
值（借用，调用方仍持有；类型 &Float）

(&mut Float) mul

XuAPI
pub fn (z &mut Float) mul(x &Float, y &Float)

用途

`&mut Float` 上的方法：相乘。

参数

z &mut Float
接收者 &mut Float（可变借用）
x &Float
值（借用，调用方仍持有；类型 &Float）
y &Float
值（借用，调用方仍持有；类型 &Float）

(&mut Float) quo

XuAPI
pub fn (z &mut Float) quo(x &Float, y &Float) int

用途

`&mut Float` 上的方法：商。失败时 throw。

参数

z &mut Float
接收者 &mut Float（可变借用）
x &Float
值（借用，调用方仍持有；类型 &Float）
y &Float
值（借用，调用方仍持有；类型 &Float）

返回

int — 该类型的值

(&Float) text

XuAPI
pub fn (z &Float) text() string

用途

`&Float` 上的方法：返回当前文本。

参数

z &Float
接收者 &Float（借用）

返回

string — 结果字符串

(&mut Float) set_string

XuAPI
pub fn (z &mut Float) set_string(s string) int

用途

`&mut Float` 上的方法：设置 string。失败时 throw。

参数

z &mut Float
接收者 &mut Float（可变借用）
s string
源字符串（string）

返回

int — 该类型的值

(&mut Float) set_float64

XuAPI
pub fn (z &mut Float) set_float64(x f64) int

用途

`&mut Float` 上的方法：设置 float64。失败时 throw。

参数

z &mut Float
接收者 &mut Float（可变借用）
x f64
值（f64）

返回

int — 该类型的值