documentation/coding_style_cn.txt: indent the code

git-svn-id: https://rt-thread.googlecode.com/svn/trunk@1826 bbd45198-f89e-11dd-88c7-29a3b14d5316
This commit is contained in:
chaos.proton@gmail.com 2011-12-05 11:11:28 +00:00
parent 2c296d4b7e
commit 75b78f85e4
1 changed files with 38 additions and 38 deletions

View File

@ -91,7 +91,7 @@ C语言头文件为了避免多次重复包含需要定义一个符号。这
接口,必须在相应的头文件中声明;如果函数入口参数是空,必须使用 void 作为入口参 接口,必须在相应的头文件中声明;如果函数入口参数是空,必须使用 void 作为入口参
数,例如: 数,例如:
rt_thread_t rt_thread_self(void); rt_thread_t rt_thread_self(void);
8.注释编写 8.注释编写
@ -110,19 +110,19 @@ rt_thread_t rt_thread_self(void);
缩进请采用 TAB 字符或 4 个空格的方式进行推荐使用4个空格的方式进行缩进。如果没 缩进请采用 TAB 字符或 4 个空格的方式进行推荐使用4个空格的方式进行缩进。如果没
有什么特殊意义,请在 "{" 的下一行都采用缩进的方式,例如: 有什么特殊意义,请在 "{" 的下一行都采用缩进的方式,例如:
if (condition) if (condition)
{ {
/* others */ /* others */
} }
唯一的例外是 swtich 语句switch-case 语句采用 case 语句与 swtich 对齐的方式, 唯一的例外是 swtich 语句switch-case 语句采用 case 语句与 swtich 对齐的方式,
例如: 例如:
switch (value) switch (value)
{ {
case value1: case value1:
break; break;
} }
case 语句与前面的 switch 语句对齐,后续的语句则采用缩进的方式。 case 语句与前面的 switch 语句对齐,后续的语句则采用缩进的方式。
@ -131,33 +131,33 @@ case 语句与前面的 switch 语句对齐,后续的语句则采用缩进的
从代码阅读角度,建议每个大括号单独占用一行,而不是跟在语句的后面,例如: 从代码阅读角度,建议每个大括号单独占用一行,而不是跟在语句的后面,例如:
if (condition) if (condition)
{ {
/* others */ /* others */
} }
匹配的大括号单独占用一行,代码阅读起来就会有相应的层次而不会容易出现混淆的情况 匹配的大括号单独占用一行,代码阅读起来就会有相应的层次而不会容易出现混淆的情况
空格建议在非函数方式的括号调用前留一个空格以和前面的进行区分,例如: 空格建议在非函数方式的括号调用前留一个空格以和前面的进行区分,例如:
if (x <= y) if (x <= y)
{ {
/* others */ /* others */
} }
for (index = 0; index < MAX_NUMBER; index ++) for (index = 0; index < MAX_NUMBER; index ++)
{ {
/* others */ /* others */
} }
建议在括号前留出一个空格涉及的包括if、for、while、swtich语句而运算表达式 建议在括号前留出一个空格涉及的包括if、for、while、swtich语句而运算表达式
中,运算符与字符串间留一个空格。另外,不要在括号的表达式两侧留空格,例如: 中,运算符与字符串间留一个空格。另外,不要在括号的表达式两侧留空格,例如:
if ( x <= y ) if ( x <= y )
{ {
/* other */ /* other */
} }
这样括号内两侧的空格是不允许的。 这样括号内两侧的空格是不允许的。
@ -187,21 +187,21 @@ if ( x <= y )
RT-Thread 内核采用了 C 语言对象化技术,命名表现形式是:对象名结构体表示类定义、 RT-Thread 内核采用了 C 语言对象化技术,命名表现形式是:对象名结构体表示类定义、
对象名 + 动词短语形式表示类方法,例如: 对象名 + 动词短语形式表示类方法,例如:
struct rt_timer struct rt_timer
{ {
struct rt_object parent; struct rt_object parent;
/* other fields */ /* other fields */
}; };
typedef struct rt_timer* rt_timer_t; typedef struct rt_timer* rt_timer_t;
结构体定义rt_timer代表了timer对象的类定义 结构体定义rt_timer代表了timer对象的类定义
rt_timer_t rt_timer_create(const char* name, rt_timer_t rt_timer_create(const char* name,
void (*timeout)(void* parameter), void* parameter, void (*timeout)(void* parameter), void* parameter,
rt_tick_t time, rt_uint8_t flag); rt_tick_t time, rt_uint8_t flag);
rt_err_t rt_timer_delete(rt_timer_t timer); rt_err_t rt_timer_delete(rt_timer_t timer);
rt_err_t rt_timer_start(rt_timer_t timer); rt_err_t rt_timer_start(rt_timer_t timer);
rt_err_t rt_timer_stop(rt_timer_t timer); rt_err_t rt_timer_stop(rt_timer_t timer);
rt_timer + 动词短语的形式表示能够应用于 timer 对象的方法。 rt_timer + 动词短语的形式表示能够应用于 timer 对象的方法。