Insert Numbers Pro/插入数字序列
Insert Numbers Pro
简介
插件市场已经有很多类似的小插件,可是我为什么又重新造了个轮子呢?在体验了类似的插件后我发现都不支持中文数字,想起我之前写了个npm就是用来支持数字与中文数字之间的转换的,心里突然就有了想法(用了那么多年别人的插件早就想体验一下插件开发了).这个插件除了,支持插入中文数序列字外,还使用了我另外一个npm包使用类似python格式化字符串方法进行数字或字符串经过格式化后插入.相当喜欢python的格式描述符,简单/易学/易用/功能强大.
特性:
- 可输出自定义格式化后的有序字符序列
指定变量对齐方式
指定输出进制转换(二进制,八进制,十六进制)
指定进制类型符号大小写显示
指定是否标注正负号
指定0填充位
指定变量输出宽度
指定千分位分隔符
指定小数点后位数
指定科学计数法输出
- 支持中文数字序列
- 可输出中英文完整/缩写星期
- python fstring格式化风格,简单好用
用法
参数配置
默认参数为:d:0:1如需自定义默认值按照vscode>文件>首选项>设置>打开设置(json)添加配置
insertnumbers.formatStr: string = ":d",
insertnumbers.start = 0,
insertnumbers.step = 1,
insertnumbers.isChineseNumFormOne = false,
其中formatStr为默认格式描述符,start为起始数,step为步长,isChineseNumFormOne为针对中文,中英星期默认从1开始计数.
使用
使用鼠标中键或按住alt键加选多列或使用快捷键ctrl+d选择多列
按下f1 键入insert numbers 或使用快捷键ctrl+alt+n调用本插件
按照提示键入参数(默认为:d:1:0,即整数起始为1步长为1)
按下回车插入序列
动图演示
默认插入
格式化插入数字序列
插入中文数字
插入星期
参数
默认参数:(default) :d:0:1
参数说明::format or :format:start:step
:format python fstring格式描述符
:start 数列起始位置
:step 累加步长
格式描述符
format [[fill]align][sign][#][0][width][tsep][dsep precision][type][^1]
fstring 格式描述符图解[^2]
f-string 语法[^3]
f-string采用 {content:format} 设置字符串格式，其中 content 是替换并填入字符串的内容，可以是变量、表达式或函数等，format是格式描述符。采用默认格式时不必指定 {:format}，如上面例子所示只写 {content} 即可。
关于格式描述符的详细语法及含义可查阅Python官方文档，这里按使用时的先后顺序简要介绍常用格式描述符的含义与作用：
对齐相关格式描述符
| 格式描述符 |
含义与作用 |
|
| < |
左对齐（字符串默认对齐方 |
式） |
| > |
右对齐（数值默认对齐方式） |
|
| ^ |
居中 |
|
数字符号相关格式描述符
| 格式描述符 |
含义与作用 |
| + |
负数前加负号（-），正数前加正号（+） |
| - |
负数前加负号（-），正数前不加任何符号（默认） |
| （空格） |
负数前加负号（-），正数前加一个空格 |
注：仅适用于数值类型。
数字显示方式相关格式描述符
注1：仅适用于数值类型.
注2：# 对不同数值类型的作用效果不同，详见下表：
| 数值类型 |
不加#（默认） |
加# |
:区别 |
| 二进制整数 |
'1111011' |
'0b1111011' |
开头是否显示 0b |
| 八进制整数 |
'173' |
'0o173' |
开头是否显示 0o |
| 十进制整数 |
'123' |
'123' |
无区别 |
| 十六进制整数（小写字母） |
'7b' |
'0x7b' |
开头是否显示 0x |
| 十六进制整数（大写字母） |
'7B' |
'0X7B' |
开头是否显示 0X |
宽度与精度相关格式描述符
| 格式描述符 |
含义与作用 |
| width |
整数 width 指定宽度 |
| 0width |
整数 width 指定宽度，开头的 0 指定高位用 0 补足宽度 |
| width |
.precision 整数 width 指定宽度，整数 precision 指定显示精度 |
注1：0width 不可用于复数类型和非数值类型，width.precision 不可用于整数类型。
注2：width.precision 用于不同格式类型的浮点数、复数时的含义也不同：用于 f、F、e、E 和 % 时 precision 指定的是小数点后的位数，用于 g 和 G 时 precision 指定的是有效数字位数（小数点前位数+小数点后位数）。
注3：width.precision 除浮点数、复数外还可用于字符串，此时 precision 含义是只使用字符串中前 precision 位字符。
千位分隔符相关格式描述符
| 格式描述符 |
含义与作用 |
| , |
使用,作为千位分隔符 |
| _ |
使用_作为千位分隔符 |
注1：若不指定 , 或 _，则f-string不使用任何千位分隔符，此为默认设置。
注2：, 仅适用于浮点数、复数与十进制整数：对于浮点数和复数，, 只分隔小数点前的数位。
注3：_ 适用于浮点数、复数与二、八、十、十六进制整数：对于浮点数和复数，_ 只分隔小数点前的数位；对于二、八、十六进制整数，固定从低位到高位每隔四位插入一个 _（十进制整数是每隔三位插入一个 _）。
格式类型相关格式描述符
| 格式描述符 |
含义与作用 |
适用变量类型 |
| s |
普通字符串格式 |
字符串 |
| b |
二进制整数格式 |
整数 |
| c |
字符格式，按unicode编码将整数转换为对应字符 |
整数 |
| d |
十进制整数格式 |
整数 |
| o |
八进制整数格式 |
整数 |
| x |
十六进制整数格式（小写字母） |
整数 |
| X |
十六进制整数格式（大写字母） |
整数 |
| e |
科学计数格式，以 e 表示 ×10^ |
浮点数、复数、整数（自动转换为浮点数） |
| E |
与 e 等价，但以 E 表示 ×10^ |
浮点数、复数、整数（自动转换为浮点数） |
| f |
定点数格式，默认精度（precision）是6 |
浮点数、复数、整数（自动转换为浮点数） |
| F |
与 f 等价，但将 nan 和 inf 换成 NAN 和 INF |
浮点数、复数、整数（自动转换为浮点数） |
| g |
通用格式，小数用 f，大数用 e |
浮点数、复数、整数（自动转换为浮点数） |
| G |
与 G 等价，但小数用 F，大数用 E |
浮点数、复数、整数（自动转换为浮点数） |
| % |
百分比格式，数字自动乘上100后按 f 格式排版，并加 % 后缀 |
浮点数、整数（自动转换为浮点数） |
注意
- 填写格式描述符时一定严格按照顺序,要求不多写不错写不乱写
- 数列默认从0开始,步长为1,如需修改在vscode>文件>首选项>设置>打开设置(json)添加配置
Advance
支持中文数字序列
使用Python的fstring格式化参数,易学易用.掌握Python的fstring语法的同学几乎0成本上手.
格式化效果齐全广泛应用于日常开发,满足一般需求.
Version
- ✅v0.0.1 发布Insert Numbers Pro,实现基本功能,测试无明显bug,优化异常抛出提示.
- 🟩v0.0.X 添加更多语法,增强鲁棒性,修复潜在BUG
