9.2. 整数内置类型
整数内置类型是int8
,int16
,int32
,int64
,uint8
,uint16
,uint32
和uint64
。 它们表示不同大小的有符号和无符号整数:
int8
表示-128
到127
之间的整数值。int16
表示-32768
和32767
之间的整数值。int32
表示-2147483648
到2147483647
之间的整数值。int64
表示-9223372036854775808
和9223372036854775807
之间的整数值。uint8
表示0
到255
之间的整数值。uint16
表示0
和65535
之间的整数值。uint32
表示0
和4294967295
之间的整数值。uint64
表示0
和18446744073709551615
之间的整数值。
9.2.1. 词汇表示
整数值在词汇上表示为可选符号(“+
”或“-
”),后面跟随一个十进制数字序列。 如果没有指定符号,则假定为“+
”。
为方便起见,在为YANG
模块中的整数指定默认值时,可以使用代表十六进制或八进制表示法中的值的替代词汇表示法。
十六进制符号由可选符号(“+
”或“-
”)组成,后跟字符“0x
”,后跟十六进制数字,其中字母可以是大写或小写。
八进制符号由一个可选符号(“+
”或“-
”)组成,后跟字符“0
”,后面跟着一些八进制数字。
请注意,如果
YANG
模块中的默认值具有前导零(“0
”),则将其解释为八进制数。 在XML
编码中,整数总是被解释为十进制数,并且允许前导零。
例子:
// 合法值
+4711 // 合法正数值
4711 // 合法正数值
-123 // 合法负数值
0xf00f // 合法的十六进制值
-0xf // 合法的十六进制值
052 // 合法的八进制值
// 非法值
- 1 // 中间空格非法
9.2.2. 规范形式
正整数的规范形式不包含符号“+
”。 前导零是被禁止的。 零值表示为“0
”。
9.2.3. 限制
所有整数类型都可以用“range
”语句限制(见第9.2.4节)。
9.2.4. “range
”声明
“range
”语句是“type
”语句的可选子语句,它将范围表达式字符串作为参数。它用于限制整型和十进制内置类型,或从它们派生的类型。
一个范围由一个显式值或者一个包含下界的连续点组成,两个连续的点“..
”和一个上限界限。可以给出多个值或范围,用“|
”分隔。如果给出了多个值或范围,它们都必须是不相交的,并且必须按照升序排列。如果范围限制应用于已经限制范围的类型,那么新的限制必须是等同限制或更多限制,即提高下限,减少上限,删除显式值或范围或将范围拆分为多个范围与中间差距。在范围表达式中给出的每个显式值和范围边界值必须与被限制的类型匹配,或者是特殊值“min
”或“max
”之一。 “min
”和“max
”分别表示被限制类型接受的最小值和最大值。
范围表达式语法由第14节中的“range-arg
”规则正式定义。
9.2.4.1. range
子语句
+---------------+---------+-------------+
| substatement | section | cardinality |
+---------------+---------+-------------+
| description | 7.21.3 | 0..1 |
| error-app-tag | 7.5.4.2 | 0..1 |
| error-message | 7.5.4.1 | 0..1 |
| reference | 7.21.4 | 0..1 |
+---------------+---------+-------------+
9.2.5. 使用示例
typedef my-base-int32-type {
type int32 {
range "1..4 | 10..20";
}
}
typedef my-type1 {
type my-base-int32-type {
// legal range restriction
range "11..max"; // 11..20
}
}
typedef my-type2 {
type my-base-int32-type {
// illegal range restriction
range "11..100";
}
}