RT-Thread finsh源码分析: finsh_var.h

/*
 *  Variable implementation in finsh shell.
 *
 * COPYRIGHT (C) 2006 - 2013, RT-Thread Development Team
 *
 *  This file is part of RT-Thread (http://www.rt-thread.org)
 *  Maintainer: bernard.xiong <bernard.xiong at gmail.com>
 *
 *  All rights reserved.
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License along
 *  with this program; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Change Logs:
 * Date           Author       Notes
 * 2010-03-22     Bernard      first version
 */
#ifndef __FINSH_VAR_H__
#define __FINSH_VAR_H__

#include <finsh.h>

/*
 * The variable in finsh is put in data segment as a global variable.
 * The 'finsh_var' structure presents the structure of variable in data segment.
 */

/*
 * finsh_var是全局变量，属于数据段
 */
struct finsh_var
{
        //数组长度加1，可以在循环中避免>=或者<=临界问题，增加代码可读性
char name[FINSH_NAME_MAX + 1];/* the name of variable */

        //错误类型
u_char type;/* the type of variable */

        //联合，模糊定义，动态扩展
/* variable value */
union {
char char_value;
short short_value;
intint_value;
longlong_value;
void*ptr;
}value;
};
//声明为全局数据，注意数组未初始化，应该放在.bss段
extern struct finsh_var global_variable[];

int finsh_var_init(void);  //数组global_variable初始化
int finsh_var_insert(const char* name, int type); //插入var到数组global_variable
int finsh_var_delete(const char* name);  //从数组移出var
struct finsh_var* finsh_var_lookup(const char* name);  //查找var

#endif