MDK使用AStyle进行代码自动格式化

原创 嵌入式Lee 2023-09-21 08:00

1. 下载软件

1.1 进入网址https://sourceforge.net/projects/astyle/files/latest/download,下载最新版本AStyle

 

1.2 解压压缩包到MDK安装目录

 

2. 配置MDK

2.1 Tools -> CustomizeTools Menu...

 

2.2 点击Menu Content后的虚线框按钮(New (Insert))

输入新建的菜单名:格式化本文件

指定AStyle.exe的路径

指定参数 !E

 

同样方式再新建一个菜单项(格式化所有文件):

 

注:!E 表示的是当前获得焦点且正在编辑的文件。

  $E*.c$E*.h代表当前获得焦点且正在编辑文件所在目录下所有.c.h文件(参考keil uVision的帮助文档)    

使用的是Astyle默认格式来格式化文件,另外也可以自定义格式,自定义格式参考Astyle的帮助文档。默认格式化后,会备份原文件为源文件名.orig。如果不想让Astyle备份文件,可以使用-n参数。如:-n !E (表示格式化当前文件,不备份)

3. 使用

打开待转换文件

点击菜单即可

 

自动转换。

4. 符合spacety编程规范的格式化参数

根据spacety编程规范,使用以下参数进行格式化

格式化本文档,复制以下文本设置

!E -A1 -s4 -xk -xV -xc -S -xW -Y -f -p -xg -U -xe -k1 -W3

格式化整个文件夹文档,复制以下文本设置

"$E*.c" "$E*.h" -A1 -s4 -xk -xV -xc -S -xW -Y -f -p -xg -U -xe -k1 -W3

 

 

以下是符合spacety编程规范的参数的解释,其他参数参参考《5.参考文档》

4.1 大括号

--style=allman / --style=bsd / --style=break / -A1

该参数指定大括号左边单独成一行对齐,


      if (input.interface == if_a) {            ifout = if_b;        } else {            ifout = if_a;        }


变为


     if (input.interface == if_a)        {            ifout = if_b;        }        else        {            ifout = if_a;        }


4.2 TAB和空格

-s4 / --indent=spaces=4

默认即TAB为上述参数设置,TAB4个空格。


   if (input.interface == if_a)        {        ifout = if_b;        }        else        {  ifout = if_a;        }


变为


    if (input.interface == if_a)        {            ifout = if_b;        }        else        {            ifout = if_a;        }

      


4.3 头文件的extern c申明

--attach-extern-c / -xk

设置该参数后extern "C" { 语句最后的{}不单独成行。优先于4.1的设置。

正常模式如下


#ifdef __cplusplus extern "C" {#endif

 


按照1设置后会变为


#ifdef __cplusplus extern "C" {#endif


#ifdef __cplusplus extern "C" {#endif

4.4 while语句

--attach-closing-while / -xV

设置该参数后while语句最后的}不单独成行。优先于4.1的设置。


do{}while(x == 1);


变为


do{}while(x == 1);


4.5 结构体/

--attach-classes / -xc

设置该参数后结构体语句后的{不单独成行。优先于4.1的设置。

总是如下:


class FooClass {...};


4.5 Switch语句

--indent-switches / -S


switch (foo){case 1:    a += 1;    break;case 2:{    a += 2;    break;}}becomes:switch (foo){    case 1:        a += 1;        break;
case 2: { a += 2; break;}}


4.6 条件编译

--indent-preproc-block / -xW

设置该参数,条件编译会缩进


#ifdef _WIN32#include #ifndef NO_EXPORT#define EXPORT#endif#endifbecomes:#ifdef _WIN32    #include     #ifndef NO_EXPORT        #define EXPORT    #endif#endif


4.8 注释对齐

--indent-col1-comments / -Y

设置该参数,注释与代码对齐


void Foo()\n"{// comment    if (isFoo)        bar();}becomes:void Foo()\n"{    // comment    if (isFoo)        bar();}


4.9 空行

--break-blocks / -f

设置该参数会在块之间加空行


isFoo = true;if (isFoo) {    bar();} else {    anotherBar();}isBar = false;becomes:isFoo = true;
if (isFoo) { bar();} else { anotherBar();}
isBar = false;


4.10 操作符空格

--pad-oper / -p

设置该参数会在操作符前后空格


isFoo = true;if (isFoo) {    bar();} else {    anotherBar();}isBar = false;becomes:isFoo = true;
if (isFoo) { bar();} else { anotherBar();}
isBar = false;


4.11 逗号空格

--pad-comma / -xg

设置该参数在逗号加空格


if (isFoo(a,b))    bar(a,b);becomes:if (isFoo(a, b))    bar(a, b);


4.12 删除不必要空格

--unpad-paren / -U

设置该参数会删除不必要的空格


if ( isFoo( ( a+2 ), b ) )    bar ( a, b );becomes (with no padding option requested):if(isFoo((a+2), b))    bar(a, b);


4.13 删除空行

--delete-empty-lines / -xe

设置该参数会删除不必要的空行


void Foo(){
foo1 = 1;
foo2 = 2;}becomes:void Foo(){ foo1 = 1; foo2 = 2;}


4.14 指针

--align-pointer=type / -k1

设置该参数指针符号* 与类型靠紧


char* foo1;char & foo2;string ^s1;becomes (with align-pointer=type):char* foo1;char& foo2;string^ s1;


4.15 引用

--align-reference=name / -W3

设置该参数引用符号& 与变量名靠紧


char& foo3;becomes(with align-reference=name):char &foo3;


5. 参考文档

《软件目录/doc/astyle.html


评论
  • 2024年是很平淡的一年,能保住饭碗就是万幸了,公司业绩不好,跳槽又不敢跳,还有一个原因就是老板对我们这些员工还是很好的,碍于人情也不能在公司困难时去雪上加霜。在工作其间遇到的大问题没有,小问题还是有不少,这里就举一两个来说一下。第一个就是,先看下下面的这个封装,你能猜出它的引脚间距是多少吗?这种排线座比较常规的是0.6mm间距(即排线是0.3mm间距)的,而这个规格也是我们用得最多的,所以我们按惯性思维来看的话,就会认为这个座子就是0.6mm间距的,这样往往就不会去细看规格书了,所以这次的运气
    wuliangu 2025-01-21 00:15 324浏览
  • 临近春节,各方社交及应酬也变得多起来了,甚至一月份就排满了各式约见。有的是关系好的专业朋友的周末“恳谈会”,基本是关于2025年经济预判的话题,以及如何稳定工作等话题;但更多的预约是来自几个客户老板及副总裁们的见面,他们为今年的经济预判与企业发展焦虑而来。在聊天过程中,我发现今年的聊天有个很有意思的“点”,挺多人尤其关心我到底是怎么成长成现在的多领域风格的,还能掌握一些经济趋势的分析能力,到底学过哪些专业、在企业管过哪些具体事情?单单就这个一个月内,我就重复了数次“为什么”,再辅以我上次写的:《
    牛言喵语 2025-01-22 17:10 178浏览
  • 嘿,咱来聊聊RISC-V MCU技术哈。 这RISC-V MCU技术呢,简单来说就是基于一个叫RISC-V的指令集架构做出的微控制器技术。RISC-V这个啊,2010年的时候,是加州大学伯克利分校的研究团队弄出来的,目的就是想搞个新的、开放的指令集架构,能跟上现代计算的需要。到了2015年,专门成立了个RISC-V基金会,让这个架构更标准,也更好地推广开了。这几年啊,这个RISC-V的生态系统发展得可快了,好多公司和机构都加入了RISC-V International,还推出了不少RISC-V
    丙丁先生 2025-01-21 12:10 619浏览
  • 数字隔离芯片是一种实现电气隔离功能的集成电路,在工业自动化、汽车电子、光伏储能与电力通信等领域的电气系统中发挥着至关重要的作用。其不仅可令高、低压系统之间相互独立,提高低压系统的抗干扰能力,同时还可确保高、低压系统之间的安全交互,使系统稳定工作,并避免操作者遭受来自高压系统的电击伤害。典型数字隔离芯片的简化原理图值得一提的是,数字隔离芯片历经多年发展,其应用范围已十分广泛,凡涉及到在高、低压系统之间进行信号传输的场景中基本都需要应用到此种芯片。那么,电气工程师在进行电路设计时到底该如何评估选择一
    华普微HOPERF 2025-01-20 16:50 123浏览
  •     IPC-2581是基于ODB++标准、结合PCB行业特点而指定的PCB加工文件规范。    IPC-2581旨在替代CAM350格式,成为PCB加工行业的新的工业规范。    有一些免费软件,可以查看(不可修改)IPC-2581数据文件。这些软件典型用途是工艺校核。    1. Vu2581        出品:Downstream     
    电子知识打边炉 2025-01-22 11:12 134浏览
  • 飞凌嵌入式基于瑞芯微RK3562系列处理器打造的FET3562J-C全国产核心板,是一款专为工业自动化及消费类电子设备设计的产品,凭借其强大的功能和灵活性,自上市以来得到了各行业客户的广泛关注。本文将详细介绍如何启动并测试RK3562J处理器的MCU,通过实际操作步骤,帮助各位工程师朋友更好地了解这款芯片。1、RK3562J处理器概述RK3562J处理器采用了4*Cortex-A53@1.8GHz+Cortex-M0@200MHz架构。其中,4个Cortex-A53核心作为主要核心,负责处理复杂
    飞凌嵌入式 2025-01-24 11:21 47浏览
  • 故障现象 一辆2007款日产天籁车,搭载VQ23发动机(气缸编号如图1所示,点火顺序为1-2-3-4-5-6),累计行驶里程约为21万km。车主反映,该车起步加速时偶尔抖动,且行驶中加速无力。 图1 VQ23发动机的气缸编号 故障诊断接车后试车,发动机怠速运转平稳,但只要换挡起步,稍微踩下一点加速踏板,就能感觉到车身明显抖动。用故障检测仪检测,发动机控制模块(ECM)无故障代码存储,且无失火数据流。用虹科Pico汽车示波器测量气缸1点火信号(COP点火信号)和曲轴位置传感器信
    虹科Pico汽车示波器 2025-01-23 10:46 80浏览
  • 高速先生成员--黄刚这不马上就要过年了嘛,高速先生就不打算给大家上难度了,整一篇简单但很实用的文章给大伙瞧瞧好了。相信这个标题一出来,尤其对于PCB设计工程师来说,心就立马凉了半截。他们辛辛苦苦进行PCB的过孔设计,高速先生居然说设计多大的过孔他们不关心!另外估计这时候就跳出很多“挑刺”的粉丝了哈,因为翻看很多以往的文章,高速先生都表达了过孔孔径对高速性能的影响是很大的哦!咋滴,今天居然说孔径不关心了?别,别急哈,听高速先生在这篇文章中娓娓道来。首先还是要对各位设计工程师的设计表示肯定,毕竟像我
    一博科技 2025-01-21 16:17 159浏览
  • 现在为止,我们已经完成了Purple Pi OH主板的串口调试和部分配件的连接,接下来,让我们趁热打铁,完成剩余配件的连接!注:配件连接前请断开主板所有供电,避免敏感电路损坏!1.1 耳机接口主板有一路OTMP 标准四节耳机座J6,具备进行音频输出及录音功能,接入耳机后声音将优先从耳机输出,如下图所示:1.21.2 相机接口MIPI CSI 接口如上图所示,支持OV5648 和OV8858 摄像头模组。接入摄像头模组后,使用系统相机软件打开相机拍照和录像,如下图所示:1.3 以太网接口主板有一路
    Industio_触觉智能 2025-01-20 11:04 195浏览
  •  万万没想到!科幻电影中的人形机器人,正在一步步走进我们人类的日常生活中来了。1月17日,乐聚将第100台全尺寸人形机器人交付北汽越野车,再次吹响了人形机器人疯狂进厂打工的号角。无独有尔,银河通用机器人作为一家成立不到两年时间的创业公司,在短短一年多时间内推出革命性的第一代产品Galbot G1,这是一款轮式、双臂、身体可折叠的人形机器人,得到了美团战投、经纬创投、IDG资本等众多投资方的认可。作为一家成立仅仅只有两年多时间的企业,智元机器人也把机器人从梦想带进了现实。2024年8月1
    刘旷 2025-01-21 11:15 666浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦