智能小程序 Ray 开发面板 SDK —— 工具方法中数值 SDK 汇总

数值

本文介绍数值相关工具。

获取指定长度字符串

名称

toFixedString

描述

补齐或者从后截取规定长度的所给字符串。

请求参数

参数	数据类型	说明	是否必填
value	number	值	是
length	number	返回的字符串的长度	是

返回参数

参数	数据类型	说明
result	string	字符串

请求示例

import { utils } from '@ray-js/panel-sdk';
const { toFixedString } = utils;
 
toFixedString(value, length);
// Example:
toFixedString(111, 5);
toFixedString(3456111, 5);

返回示例

'00111';
'56111';

补齐字符串

名称

toFilledString

描述

补齐输出规定长度的字符串，若字符串本身超过规定长度则直接输出。

请求参数

参数	数据类型	说明	是否必填
value	number	值	是
length	number	返回的字符串的长度	是

返回参数

参数	数据类型	说明
result	string	字符串

请求示例

import { utils } from '@ray-js/panel-sdk';
const { toFilledString } = utils;
 
toFilledString(value, length);
// Example:
toFixedString(111, 5);
toFixedString(3456111, 5);

返回示例

'00111';
'3456111';

八位数组转十六进制

名称

bytesToHexString

描述

返回八位整数的数字数组转十六进制后的字符串，分高低位。

请求参数

参数	数据类型	说明	是否必填
array	number	一个 8 位整数的数字数组	是

返回参数

参数	数据类型	说明
result	string	转换而来的字符串

请求示例

import { utils } from '@ray-js/panel-sdk';
const { bytesToHexString } = utils;
 
bytesToHexString(array);
// example:
bytesToHexString([1, 2]);
bytesToHexString([23, 2]);

返回示例

'0102';
'1702';

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。   

十进制转十六进制

名称

numToByteNumbers

描述

返回十进制转十六进制后的字符串。

请求参数

参数	数据类型	说明	是否必填
value	number	值	是

返回参数

参数	数据类型	说明
result	string	转换而来的字符串，每个字符都是十六进制字符

请求示例

import { utils } from '@ray-js/panel-sdk';
const { numToByteNumbers } = utils;
 
numToByteNumbers(value);
// Example:
numToHexString(111);
numToHexString(15);

返回示例

'6f';
'0f';

十进制转高低八位

名称

intToHighLow

描述

返回十进制转十六进制后的字符串。

请求参数

参数	数据类型	说明	是否必填
value	number	值	是

返回参数

参数	数据类型	说明
result	number	一个数的数组，第一个是高八个数，第二个是低八个数

请求示例

import { utils } from '@ray-js/panel-sdk';
const { intToHighLow } = utils;
 
intToHighLow(value);
// Example:
highLowToInt(2838);
highLowToInt(5643);

返回示例

[11, 22][(22, 11)];

返回中间值

名称

inMaxMin

描述

返回最大最小和具体值三个数中的中间值。

请求参数

名参数	数据类型	说明	是否必填
min	number	最小值	是
max	number	最大值	是
value	number	具体值	是

返回参数

参数	数据类型	说明
result	number	返回三个数中的中间值

请求示例

import { utils } from '@ray-js/panel-sdk';
const { inMaxMin } = utils;
 
inMaxMin(min, max, value);
// Example:
inMaxMin(1, 2838, 233);
inMaxMin(1, 2, 0);

返回示例

233;
1;

放缩数值

名称

scaleNumber

描述

返回放缩 10 的 num 次幂的数值。

请求参数

参数	数据类型	说明	是否必填
num	number	10 的指数幂	是
value	number	值	是

返回参数

参数	数据类型	说明
result	number	value / Math.pow(10, scale)

请求示例

import { utils } from '@ray-js/panel-sdk';
const { scaleNumber } = utils;
 
scaleNumber(num, value);
// Example:
scaleNumber(2, 10245);

返回示例

102.45;

返回指定数组

名称

range

描述

返回从 start 到 end，步长为 step 的数组。

请求参数

参数	数据类型	说明	是否必填
start	number	初始值	是
end	number	结束值	是
value	number	步长	是

返回参数

参数	数据类型	说明
result	number	返回从 start 到 end，步长为 step 的数组

请求示例

import { utils } from '@ray-js/panel-sdk';
const { range } = utils;
 
range(start, end, value);
// Example:
range(1, 10);
range(1, 10, 2);

返回示例

[1, 2, 3, 4, 5, 6, 7, 8, 9][(1, 3, 5, 7, 9)];

转换数值

名称

calcPosition

描述

将原先范围内的值，转换为新范围内的值。

请求参数

参数	数据类型	说明	是否必填
value	number	原先值	是
min	number	原先最小范围	是
max	number	原先最大范围	是
newMin	number	新最小范围	是
newMax	number	新最大范围	是

返回参数

参数	数据类型	说明
result	number	((value - min) * newRange) / oldRange + newMin

请求示例

import { utils } from '@ray-js/panel-sdk';
const { calcPosition } = utils;
 
calcPosition(value, min, max, newMin, newMax);
// Example:
calcPosition(50, 0, 100, -100, 0);
calcPosition(255, 0, 255, 0, 100);

返回示例

-50;
100;

新范围的百分比

名称

calcPercent

描述

新范围的百分比。

请求参数

参数	数据类型	说明	是否必填
min	number	最小值	是
max	number	最大值	是
value	number	具体值	是
offset	number	百分比起始偏移量(0 - 1)	否

返回参数

参数	数据类型	说明
result	number	新范围的百分比

请求示例

import { utils } from '@ray-js/panel-sdk';
const { calcPercent } = utils;
 
calcPercent(min, max, value, offset);
// Example:
calcPercent(25, 255, 25);
calcPercent(25, 255, 25, 0.1);

返回示例

0;
0.1;

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。