ARM单片机上的C语言库＜setjmp.h＞的使用

     在看别人的$ARM$单片机的程序的时候，看见了对$setjmp$的调用，跳转过去之后发现还是库的内容，我以前也没有碰见过，于是这在这里记录以下。
     要调用$setjmp$只要把头文件$setjmp.h$包含进来就可以了，我这边看到的是这个头文件位于$KEIL$的安装目录，如图1所示。这个应该也是$C$语言标准库的内容，具体可以参考维基百科以及这个地方的讲解。

　

图1.

     下面的讲解我主要参考了这篇博客。其实这里也没有太多内容，$setjmp.h$这个头文件主要声明了两个函数和一个类型，具体可以到该头文件里面查看，也可以看图2。类型$jmp\_buf$定义的是一个数组类型，函数$intsetjmp(jmp\_bufenv)$用来保存调用该函数的位置整个程序环境到变量$env$，第一次调用函数$setjmp$时返回值为0，调用函数$voidlongjmp(jmp\_bufenv,intval)$（调用时参数$env$的值为前面调用函数$setjmp$所存储的程序环境参数）会重新回到前面调用函数$setjmp$的位置，且此时函数$setjmp$的返回值为调用函数$longjmp$的参数$val$。这就有一点类似于$C$语言的$goto$语句，但是$goto$语句只能在一个函数内部进行跳转，但是$setjmp$和$longjmp$一起来使用的话可以在不同的函数之间进行跳转。

　

图2.

     下面我们直接上一段代码，下面的代码在正点原子的$STM32F103$精英开发板上测试的。图3、图4和图5是当$main$函数中调用函数$function\_c$的时候的参数分别为4、5、8的时候的输出情况。

#include "usart.h"
#include <stdio.h>
#include <setjmp.h>

jmp_buf jmpbuffer;

int function_a(int p_a) 
{
    int result = p_a * 2 - 10;
    if (result < 0) 
	{
        longjmp(jmpbuffer, 5);
    }
    return result;
}
int function_b(int p_b) 
{
    int result = function_a(p_b) + 6;
    if (result > 10) 
	{
        longjmp(jmpbuffer, 10);
    }
    return result;
}
int function_c(int p_c) 
{
    return function_b(p_c)+1;
}
int main() 
{
    int jumpValue=-1;	
    uart_init(115200);
	printf("\"setjmp.h\" file test start.\r\n");		
    jumpValue = setjmp(jmpbuffer);
	printf("Slection start,jumpValue=%d.\r\n",jumpValue);	
    if( jumpValue == 5 ) 
	{
        printf("Error happened in function function_a.\r\n");
    }
	else if ( jumpValue == 10 ) 
	{
        printf("Error happened in function function_b.\r\n");
    }
	else 
	{ 
        int result = function_c(5);
        printf("No error happened,result = %d.\r\n", result);
    }
	printf("\"setjmp.h\" file test end.\r\n");			
	while(1);
    return 0;
}

　

图3.

　

图4.

　

图5.