文章目录
第五十九章 Caché 函数大全 $SCONVERT 函数 - a大纲
-
- 参数
- 描述
- 示例
将二进制编码值转换为数字。
大纲$SCONVERT(s,format,endian,position) $SC(s,format,endian,position)
参数
- s 一串8位字节,编码为一个数字。有效值的限制取决于所选的格式。
- format 以下格式代码之一,指定为带引号的字符串:S1,S2,S4,S8,U1,U2,U4,F4或F8。
- endian 可选—布尔值,其中0 =小端,而1 =大端。默认值为0。
- position 可选-开始转换的8位字节字符串中的字符位置。字符位置从1开始计算。默认值为1。如果指定位置,则必须指定endian或占位符逗号。
$SCONVERT使用指定的格式将s从8位字节的编码字符串转换为数值。
以下是受支持的格式代码:
- S1 有符号整数,编码为一个8位字节的字符串。该值必须在-128到127(含)范围内。
- S2 有符号整数,编码为两个8位字节的字符串。该值必须在-32768到32767(包括)之间。
- S4 有符号整数,编码为四个8位字节的字符串。该值必须在-2147483648到2147483647之间(含)。
- S8 带符号的整数,编码为八个8位字节的字符串。该值必须在-9223372036854775808到9223372036854775807(含)之间。
- U1 无符号整数编码为一个8位字节的字符串。最大值为256。
- U2 无符号整数编码为两个8位字节的字符串。最大值为65535。
- U4 无符号整数编码为四个8位字节的字符串。最大值是4294967295。
- F4 IEEE浮点数编码为四个8位字节的字符串。
- F8 IEEE浮点数编码为八个8位字节的字符串。
字符串s必须包含从指定字符位置开始和之后的足够字符,以满足格式代码所需的8位字节数。例如,$SCONVERT(s,"S4",0,9)要求s的长度至少为12个字符,因为解码结果来自字符位置9、10、11和12。超出此范围的值将导致<VALUE OUT OF RANGE>错误。
$SCONVERT仅适用于8位字节字符串。如果$SCONVERT在Caché的Unicode实例上,并且编码字符串中的任何字符在$CHAR(256)到$CHAR(65536)范围内,则返回值是不可预测的。
如果参数s是数字值,则在解码之前将其转换为包含规范数字形式的字符串。
可以使用IsBigEndian()类方法来确定在操作系统平台上使用的位顺序:1 = big-endian位顺序; 0 =小端位顺序。
DHC-APP>WRITE $SYSTEM.Version.IsBigEndian() 0
$SCONVERT提供$NCONVERT运算的逆函数。
示例在下面的示例中,$SCONVERT将两字节的二进制编码值转换为数字:
/// d ##class(PHA.TEST.Function).SCONVERT() ClassMethod SCONVERT() { SET x=$NCONVERT(258,"U2") ZZDUMP x SET y=$SCONVERT(x,"U2") WRITE !,y }
0000: 02 01 为258的十六进制102
DHC-APP>d ##class(PHA.TEST.Function).SCONVERT() 0000: 02 01 .. 258
下面的示例$SCONVERT将大字节序的两字节二进制编码值转换为数字:
/// d ##class(PHA.TEST.Function).SCONVERT1() ClassMethod SCONVERT1() { SET x=$NCONVERT(258,"U2",1) ZZDUMP x SET y=$SCONVERT(x,"U2",1) WRITE !,y }
DHC-APP>d ##class(PHA.TEST.Function).SCONVERT1() 0000: 01 02 .. 258