语法速查表

Markdown 语法速查表 | Markdown 官方教程

Excerpt

Markdown 速查表提供了所有 Markdown 语法元素的基本解释。如果你想了解某些语法元素的更多信息,请参阅更详细的 基本语法 和 扩展语法.


# 总览

Markdown 速查表提供了所有 Markdown 语法元素的基本解释。如果你想了解某些语法元素的更多信息,请参阅更详细的 基本语法扩展语法.

# 基本语法

这些是 John Gruber 的原始设计文档中列出的元素。所有 Markdown 应用程序都支持这些元素。

元素 Markdown 语法
标题(Heading) # H1 ## H2 ### H3
粗体(Bold) **bold text**
斜体(Italic) *italicized text*
引用块(Blockquote) > blockquote
有序列表(Ordered List) 1. First item
2. Second item
3. Third item
无序列表(Unordered List) - First item - Second item - Third item
代码(Code) `code`
分隔线(Horizontal Rule) ---
链接(Link) [title](https://www.example.com)
图片(Image) ![alt text](image.jpg)

# 扩展语法

这些元素通过添加额外的功能扩展了基本语法。但是,并非所有 Markdown 应用程序都支持这些元素。

元素 Markdown 语法
表格(Table) `
代码块(Fenced Code Block) ``` {   "firstName": "John",   "lastName": "Smith",   "age": 25 } ```
脚注(Footnote) Here’s a sentence with a footnote. [^1]
[^1]: This is the footnote.
标题编号(Heading ID) ### My Great Heading {#custom-id}
定义列表(Definition List) term : definition
删除线(Strikethrough) ~~The world is flat.~~
任务列表(Task List) - [x] Write the press release - [ ] Update the website - [ ] Contact the media

汇编调试

汇编

  1. 打印寄存器的值:

    i register

  2. 打印所有寄存器的值:

    i all-registers

  3. 打印单个寄存器的值

    i registers regname 或
    p $regname”

  4. 修改寄存器的值

    例子

1
2
3
4
5
6
7
8
9
10
#include <stdio.h>
int main(void)
{
int a =0;

a++;
a++;
printf("%d\n", a);
return 0;
}

PC寄存器会存储程序下一条要执行的指令,通过修改这个寄存器的值,可以达到改变程序执行流程的目的。上面的程序会输出“a=2”,下面介绍一下如何通过修改PC寄存器的值,改变程序执行流程。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
4               int a =0;
(gdb) disassemble main
Dump of assembler code for function main:
0x08050921 <main+0>: push %ebp
0x08050922 <main+1>: mov %esp,%ebp
0x08050924 <main+3>: sub $0x8,%esp
0x08050927 <main+6>: and $0xfffffff0,%esp
0x0805092a <main+9>: mov $0x0,%eax
0x0805092f <main+14>: add $0xf,%eax
0x08050932 <main+17>: add $0xf,%eax
0x08050935 <main+20>: shr $0x4,%eax
0x08050938 <main+23>: shl $0x4,%eax
0x0805093b <main+26>: sub %eax,%esp
0x0805093d <main+28>: movl $0x0,-0x4(%ebp)
0x08050944 <main+35>: lea -0x4(%ebp),%eax
0x08050947 <main+38>: incl (%eax)
0x08050949 <main+40>: lea -0x4(%ebp),%eax
0x0805094c <main+43>: incl (%eax)
0x0805094e <main+45>: sub $0x8,%esp
0x08050951 <main+48>: pushl -0x4(%ebp)
0x08050954 <main+51>: push $0x80509b4
0x08050959 <main+56>: call 0x80507cc <printf@plt>
0x0805095e <main+61>: add $0x10,%esp
0x08050961 <main+64>: mov $0x0,%eax
0x08050966 <main+69>: leave
0x08050967 <main+70>: ret
End of assembler dump.
(gdb) info line 6
Line 6 of "a.c" starts at address 0x8050944 <main+35> and ends at 0x8050949 <main+40>.
(gdb) info line 7
Line 7 of "a.c" starts at address 0x8050949 <main+40> and ends at 0x805094e <main+45>.

通过“info line 6”和“info line 7”命令可以知道两条“a++;”语句的汇编指令起始地址分别是0x8050944和0x8050949。

1
2
3
4
5
(gdb) n
6 a++;
(gdb) p $pc
$3 = (void (*)()) 0x8050944 <main+35>
(gdb) set var $pc=0x08050949

当程序要执行第一条“a++;”语句时,打印pc寄存器的值,看到pc寄存器的值为0x8050944,与“info line 6”命令得到的一致。接下来,把pc寄存器的值改为0x8050949,也就是通过“info line 7”命令得到的第二条“a++;”语句的起始地址。

1
2
3
4
5
(gdb) n
8 printf("a=%d\n", a);
(gdb)
a=1
9 return 0;

接下来执行,可以看到程序输出“a=1”,也就是跳过了第一条“a++;”语句。

GDB调试忽略信号

GDB调试忽略信号

在linux平台,用gdb调试程序时,可以在gdb attach到运行中程序后,用以下命令忽略一些不关注的信号:

handle SIGUSR2 noprint nostop

handle SIGPIPE noprint nostop

柔性数组

柔性数组

柔性数组定义

C99中,结构体中最后一个元素允许是未知大小的数组,这个成员叫做结构体的柔性数组成员。

柔型数组有两种定义方式:

1
2
3
4
5
1. typedef struct st_type
2. {
3. int i;
4. int a[0];//柔性数组成员
5. }type_a;

有些编译器会报错无法编译可以改成:

1
2
3
4
5
1. typedef struct st_type
2. {
3. int i;
4. int a[];//柔性数组成员
5. }type_a;

柔性数组的特点

(1)结构中的柔性数组成员 前面必须至少包含一个其他成员(从上面的代码可以看出)

(2)sizeof( )返回的这种结构大小不包括柔性数组的内存

1
2
3
4
5
6
7
8
9
10
11
12
13
1. #define  _CRT_SECURE_NO_WARNINGS  1
2. #include<stdio.h>
3. typedef struct st_type
4. {
5. int i;
6. int a[0];//柔性数组成员
7. }type_a;
8.
9. int main()
10. {
11. printf("sizeof(type_a) = %d\n", sizeof(type_a));
12. return 0;
13. }

打印结果为4可以看出特点(2) : 返回的结构大小不包括柔性数组的大小

(3)包含柔型数组成员的结构用malloc( )函数进行内存的动态分配,并且分配的内存应该大于结构的大小。以适应柔型数组的预期大小。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
1. #define  _CRT_SECURE_NO_WARNINGS  1
2. #include<stdio.h>
3. #include<stdlib.h>
4. typedef struct st_type
5. {
6. int i;
7. int a[0];//柔性数组成员
8. }type_a;
9.
10. int main()
11. {
12. type_a* s = (type_a*)malloc(sizeof(type_a) + 10 * sizeof(int));//根据特点3,malloc申请的空间应该比结构体大小要大
13. if (s != NULL)
14. {
15. s->i = 10;
16. int j = 0;
17. for (j = 0; j < 10; j++)
18. {
19. s->a[j] = j;
20. }
21. }
22.
23. return 0;
24. }
25.

VS2019   F10    监视内存,输入s ,内存如下所示:

如果想增加数组元素,使用realloc调整结构体大小

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
1. #define  _CRT_SECURE_NO_WARNINGS  1
2. #include<stdio.h>
3. #include<stdlib.h>
4. typedef struct st_type
5. {
6. int i;
7. int a[0];//柔性数组成员
8. }type_a;
9.
10. int main()
11. {
12. //printf("sizeof(type_a) = %d\n", sizeof(type_a));
13. type_a* s = (type_a*)malloc(sizeof(type_a) + 10 * sizeof(int));//根据特点3,malloc申请的空间应该比结构体大小要大
14. if (s != NULL)
15. {
16. s->i = 10;
17. int j = 0;
18. for (j = 0; j < 10; j++)
19. {
20. s->a[j] = j;
21. }
22. }
23.
24. type_a* ptr = (type_a*)realloc(s,sizeof(type_a) + 20 * sizeof(int));//使用realloc重新调整结构体大小
25. if (ptr != NULL)
26. {
27. s = ptr;
28. }
29.
30. //使用
31.
32. //释放
33. free(s);
34. s = NULL;
35.
36. return 0;
37. }
38.

柔性数组的优势

(1)把结构体的内存以及其成员要的内存一次性分配好了,并返回给用户一个结构体指针,用户做一次free就可以。

(2)连续的内存有益于提高访问速度,也有益于减少内存碎片。

Epoll

Epoll

**epoll**是Linux内核的可扩展I/O事件通知机制[1]。于Linux 2.5.44首度登场,它设计目的旨在取代既有POSIX select(2)poll(2)系统函数,让需要大量操作文件描述符的程序得以发挥更优异的性能(举例来说:旧有的系统函数所花费的时间复杂度为O(n),epoll的时间复杂度O(log n))。epoll 实现的功能与 poll 类似,都是监听多个文件描述符上的事件

程序接口

int epoll_create(int size);

在内核中创建epoll实例并返回一个epoll文件描述符。 在最初的实现中,调用者通过 size 参数告知内核需要监听的文件描述符数量。如果监听的文件描述符数量超过 size, 则内核会自动扩容。而现在 size 已经没有这种语义了,但是调用者调用时 size 依然必须大于 0,以保证后向兼容性。

int epoll_ctl(int epfd, int op, int fd, struct epoll_event *event);

向 epfd 对应的内核epoll 实例添加、修改或删除对 fd 上事件 event 的监听。op 可以为 EPOLL_CTL_ADD, EPOLL_CTL_MOD, EPOLL_CTL_DEL 分别对应的是添加新的事件,修改文件描述符上监听的事件类型,从实例上删除一个事件。如果 event 的 events 属性设置了 EPOLLET flag,那么监听该事件的方式是边缘触发。

int epoll_wait(int epfd, struct epoll_event *events, int maxevents, int timeout);

当 timeout 为 0 时,epoll_wait 永远会立即返回。而 timeout 为 -1 时,epoll_wait 会一直阻塞直到任一已注册的事件变为就绪。当 timeout 为一正整数时,epoll 会阻塞直到计时 timeout 毫秒终了或已注册的事件变为就绪。因为内核调度延迟,阻塞的时间可能会略微超过 timeout 毫秒。

触发模式[编辑]

epoll提供边沿触发状态触发模式。在边沿触发模式中,epoll_wait仅会在新的事件首次被加入epoll队列时返回;于level-triggered模式下,epoll_wait在事件状态未变更前将不断被触发。状态触发模式是默认的模式。

状态触发模式与边沿触发模式有读和写两种情况,我们先来考虑读的情况。假设我们注册了一个读事件到epoll实例上,epoll实例会通过epoll_wait返回值的形式通知我们哪些读事件已经就绪。简单地来说,在状态触发模式下,如果读事件未被处理,该事件对应的内核读缓冲器非空,则每次调用 epoll_wait 时返回的事件列表都会包含该事件。直到该事件对应的内核读缓冲器为空为止。而在边沿触发模式下,读事件就绪后只会通知一次,不会反复通知。

然后我们再考虑写的情况。水平触发模式下,只要文件描述符对应的内核写缓冲器未满,就会一直通知可写事件。而在边沿触发模式下,内核写缓冲器由满变为未满后,只会通知一次可写事件。

举例来说,倘若有一个已经于epoll注册之流水线接获资料,epoll_wait将返回,并发出资料读取的信号。现假设缓冲器的资料仅有部分被读取并处理,在level-triggered模式下,任何对epoll_wait之调用都将即刻返回,直到缓冲器中的资料全部被读取;然而,在edge-triggered的情境下,epoll_wait仅会于再次接收到新资料(亦即,新资料被写入流水线)时返回。

边沿触发模式[编辑]

边沿触发模式使得程序有可能在用户态缓存 IO 状态。nginx 使用的是边沿触发模式。

文件描述符有两种情况是推荐使用边沿触发模式的。

  1. read 或者 write 系统调用返回了 EAGAIN。
  2. 非阻塞的文件描述符。

可能的缺陷:

  1. 如果 IO 空间很大,你要花很多时间才能把它一次读完,这可能会导致饥饿。举个例子,假设你在监听一个文件描述符列表,而某个文件描述符上有大量的输入(不间断的输入流),那么你在读完它的过程中就没空处理其他就绪的文件描述符。(因为边沿触发模式只会通知一次可读事件,所以你往往会想一次把它读完。)一种解决方案是,程序维护一个就绪队列,当 epoll 实例通知某文件描述符就绪时将它在就绪队列数据结构中标记为就绪,这样程序就会记得哪些文件描述符等待处理。Round-Robin 循环处理就绪队列中就绪的文件描述符即可。
  2. 如果你缓存了所有事件,那么一种可能的情况是 A 事件的发生让程序关闭了另一个文件描述符 B。但是内核的 epoll 实例并不知道这件事,需要你从 epoll 删除掉。

任务列表语法

任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中,复选框将显示在内容旁边。要创建任务列表,请在任务列表项之前添加破折号-和方括号[ ],并在[ ]前面加上空格。要选择一个复选框,请在方括号[x]之间添加 x 。

1
2
3
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

呈现的输出如下所示:

  • Write the press release
  • Update the website
  • Contact the media

输出日志记录

输出日志记录

(gdb) set logging file fileName 设置文件名,文件默认生成在运行gdb命令的目录下;
(gdb) set logging on 启动日志记录;
(gdb) set height 0 这样gdb需要多行输出时,就会全部输出,中间不会暂停;
(gdb) set print elements 0 这样gdb在打印时就没有默认为200个元素的长度限制;
(gdb) thread apply all bt 在这里去实际操作,所需要的gdb命令
(gdb) set logging off