API

• cn2an.cn2an
• cn2an.cn2an

cn2an.cn2an

cn2an.cn2an(inputs=None, mode="normal")

Args:

• inputs str: 待转化输入数据。
• mode enum:str: 数据转化的模式。
  1. normal: 正常模式；
  2. strict: 严格模式；
  3. smart: 智能模式。

Returns:

• output int|float : 转化后的输出数据。

Raises:

• ValueError: 当数据不在规定的模式范围内时，抛出异常。

Examples:

import cn2an

# 在 strict 模式下，只有严格符合的才可以进行转化
output = cn2an.cn2an("一百二十三", "strict")
print(output)
# 123

# 在 normal 模式下，还可以将 一二三 进行转化
output = cn2an.cn2an("一二三")
# or output = cn2an.cn2an("一二三", "normal")
print(output)
# 123

# 在 smart 模式下，还可以将混合描述的 1百23 进行转化
output = cn2an.cn2an("1百23", "smart")
print(output)
# 123

cn2an.an2cn

cn2an.an2cn(inputs=None, mode="low")

Args:

• inputs int|float|str: 待转化输入数据。
• mode enum:str: 数据转化的模式。
  1. low: 小写模式；
  2. up: 大写模式；
  3. rmb: 人民币模式；
  4. smart: 智能模式。

Returns:

• output str : 转化后的输出数据。

Raises:

• ValueError: 当数据不在规定的模式范围内时，抛出异常。

Examples:

import cn2an

# 在 low 模式下，数字转化为小写的中文数字
output = cn2an.an2cn("123")
# or output = cn2an.an2cn("123", "low")
print(output)
# 一百二十三

# 在 up 模式下，数字转化为大写的中文数字
output = cn2an.an2cn("123")
# or output = cn2an.an2cn("123", "up")
print(output)
# 壹佰贰拾叁

# 在 rmb 模式下，数字转化为人民币专用的描述
output = cn2an.an2cn("123")
# or output = cn2an.an2cn("123", "rmb")
print(output)
# 壹佰贰拾叁元整

# 在 smart 模式下，可以将混合描述数字转化为小写的中文数字
output = cn2an.an2cn("123")
# or output = cn2an.an2cn("1百23", "smart")
print(output)
# 一百二十三