模块化C语言编程

     C语言源文件 *.c 
     提到 C语言源文件，大家都不会陌生。因为我们平常写的程序代码几乎都在这个 XX.C文件里面。编译
器也是以此文件来进行编译并生成相应的目标文件。作为模块化编程的组成基础，我们所要实现的所有功能的源代码均在这个文件里。理想的模块化应该可以看成是一个黑盒子。即我们只关心模块提供的功能，而不管模块内部的实现细节。好比我们买了一部手机，我们只需要会用手机提供的功能即可，不需要知晓它是如何把短信发出去的，如何响应我们按键的输入，这些过程对我们用户而言，就是是一个黑盒子。
在大规模程序开发中，一个程序由很多个模块组成，很可能，这些模块的编写任务被分配到不同的人。而你在编写这个模块的时候很可能就需要利用到别人写好的模块的借口，这个时候我们关心的是，它的模块实现了什么样的接口，我该如何去调用，至于模块内部是如何组织的，对于我而言，无需过多关注。而追求接口的单一性，把不需要的细节尽可能对外部屏蔽起来，正是我们所需要注意的地方。
     C语言头文件 *.h 
     谈及到模块化编程，必然会涉及到多文件编译，也就是工程编译。在这样的一个系统中，往往会有多个C文件，而且每个 C文件的作用不尽相同。在我们的 C文件中，由于需要对外提供接口，因此必须有一些函数或者是变量提供给外部其它文件进行调用。
     假设我们有一个 LCD.C 文件，其提供最基本的 LCD 的驱动函数
     LcdPutChar(char cNewValue) ;  //在当前位置输出一个字符而在我们的另外一个文件中需要调用此函数，那么我们该如何做呢？头文件的作用正是在此。可以称其为一份接口描述文件。其文件内部不应该包含任何实质性的函数代码。我们可以把这个头文件理解成为一份说明书，说明的内容就是我们的模块对外提供的接口函数或者是接口变量。同时该文件也包含了一些很重要的宏定义以及一些结构体的信息，离开了这些信息，很可能就无法正常使用接口函数或者是接口变量。但是总的原则是：不该让外界知道的信息就不应该出现在头文件里，而外界调用模块内接口函数或者是接口变量所必须的信息就一定要出现在头文件里，否则，外界就无法正确的调用我们提供的接口功能。因而为了让外部函数或者文件调用我们提供的接口功能，就必须包含我们提供的这个接口描述文件----即头文件。同时，我们自身模块也需要包含这份模块头文件(因为其包含了模块源文件中所需要的宏定义或者是结构体)，好比我们平常所用的文件都是一式三份一样，模块本身也需要包含这个头文件。

     下面我们来定义这个头文件，一般来说，头文件的名字应该与源文件的名字保持一致，这样我们便可以清晰的知道哪个头文件是哪个源文件的描述。 
     于是便得到了 LCD.C的头文件 LCD.h 其内容如下。
        #ifndef    _LCD_H_
                #define     _LCD_H_
                extern   LcdPutChar(char cNewValue) ;
        #endif
    这与我们在源文件中定义函数时有点类似。不同的是，在其前面添加了 extern 修饰符表明其是一个外部函数，可以被外部其它模块进行调用。
         #ifndef     _LCD_H_
              #define     _LCD_H_
        #endif 
        这个几条条件编译和宏定义是为了防止重复包含。假如有两个不同源文件需要调用
LcdPutChar(char cNewValue)这个函数，他们分别都通过#include “Lcd.h”把这个头文件包含了进去。在第一个源文件进行编译时候，由于没有定义过 _LCD_H_ 因此 #ifndef _LCD_H_ 条件成立，于是定义_LCD_H_ 并将下面的声明包含进去。在第二个文件编译时候，由于第一个文件包含时候，已经将_LCD_H_定义过了。因此#ifndef _LCD_H_ 不成立，整个头文件内容就没有被包含。假设没有这样的条件编译语句，那么两个文件都包含了extern LcdPutChar(char cNewValue) ; 就会引起重复包含的错误。
    不得不说的 typedef 
    很多朋友似乎了习惯程序中利用如下语句来对数据类型进行定义
        #define uint  unsigned int
        #define uchar  unsigned char
    然后在定义变量的时候 直接这样使用 
    uint  g_nTimeCounter = 0 ;
    不可否认，这样确实很方便，而且对于移植起来也有一定的方便性。但是考虑下面这种情况你还会 这么认为吗？
  #define PINT unsigned int *  //定义unsigned int 指针类型
  PINT  g_npTimeCounter, g_npTimeState ;

   那么你到底是定义了两个 unsigned int 型的指针变量，还是一个指针变量，一个整形变量呢？而你的初衷又是什么呢，想定义两个 unsigned int 型的指针变量吗？如果是这样，那么估计过不久就会到处抓狂找错误了。 庆幸的是 C语言已经为我们考虑到了这一点。typedef 正是为此而生。为了给变量起一个别名我们可以用如下的语句
    typedef  unsigned  int    uint16 ;    //给指向无符号整形变量起一个别名 uint16
      typedef  unsigned  int  * puint16 ;  //给指向无符号整形变量指针起一个别名 puint16
    在我们定义变量时候便可以这样定义了：
  uint16    g_nTimeCounter  =  0 ;  //定义一个无符号的整形变量
  puint16  g_npTimeCounter  ;    //定义一个无符号的整形变量的指针
  在我们使用51单片机的 C语言编程的时候，整形变量的范围是16位，而在基于32的微处理下的整形变量是32位。倘若我们在8位单片机下编写的一些代码想要移植到32位的处理器上，那么很可能我们就需要在源文件中到处修改变量的类型定义。这是一件庞大的工作，为了考虑程序的可移植性，在一开始，我们就应该养成良好的习惯，用变量的别名进行定义。
    如在8位单片机的平台下，有如下一个变量定义
    uint16    g_nTimeCounter  =  0 ; 
    如果移植32单片机的平台下，想要其的范围依旧为16位。
    可以直接修改 uint16 的定义，即
    typedef  unsigned  short  int    uint16 ; 
    这样就可以了，而不需要到源文件处处寻找并修改。将常用的数据类型全部采用此种方法定义，形成一个头文件，便于我们以后编程直接调用。

下面通过一个实例详细理解一下。idle_shell.h与idle_shell.c 

   idle_shell.h文件
#ifndef IDLE_SHELL_H
   #define IDLE_SHELL_H

typedef struct
{
    MMI_IDLE_SHELL_FIELD;
} mmi_idle_shell_struct;

这是定义一个结构体数据类型，要注意与变量的区分。
extern void mmi_idle_shell_update_idle_text(void);

extern void mmi_idle_shell_on_init(mmi_idle_obj_struct *obj);

    这是idle_shell.c文件的函数，要注意extern functions()中的extern是区分函数是内部函数还是外部函数。内部函数的关键字是static functions()。内部函数的意思是把函数的作用域限制在本文件中。只允许在本文件中调用该函数。不同文件中可以有相同函数名的内部函数。方便模块化编程。extern functions()是定义函数为外部函数。不加extern。默认为外部函数。所有头文件中可以不加extern.函数声明就是告诉编译器 functions为函数。

 

    还需注意 extern int a 变量在不同文件中。假如1.c文件中定义的 int a为外部变量。要在2.c文件中使用a变量的话就要用extern int a，将1.c文件中的a变量的作用域扩展到2.c文件中、也可以用extern a。

    定义外部变量 static int a。是把a的作用域限制在本文件中。可以不同文件中有相同的外部变量名。

外部变量都是静态存储的。
#endif /* defined(__MMI_VUI_SHELL_APP__) */
#endif /* IDLE_SHELL_H */

 

 

idle_shell.c文件

void mmi_idle_shell_update_idle_text(void)
{
    /*----------------------------------------------------------------*/
    /* Local Variables                                                */
    /*----------------------------------------------------------------*/

    /*----------------------------------------------------------------*/
    /* Code Body                                                      */
    /*----------------------------------------------------------------*/
    /* Idle mode text and icon. */
    vadp_p2v_hs_set_idle_mode_text((U8 *)wgui_cat033_get_extra_text());
    vadp_p2v_hs_set_idle_mode_icon((U8 *)GetSATIdleIcon());
}

void mmi_idle_shell_on_init(mmi_idle_obj_struct *obj)
{
    /*----------------------------------------------------------------*/
    /* Local Variables                                                */
    /*----------------------------------------------------------------*/
    mmi_idle_shell_struct *p;
    mmi_idle_capability_struct *capability;

    /*----------------------------------------------------------------*/
    /* Code Body                                                      */
    /*----------------------------------------------------------------*/
    mmi_idle_obj_on_init(obj);

    p = (mmi_idle_shell_struct *)obj;

    /* Member variable. */
    p->type = MMI_IDLE_TYPE_SHELL;

    /* Member function. */
    p->on_enter = mmi_idle_shell_on_enter;
    p->on_update_service_area = mmi_idle_shell_on_update_service_indication;

    /* Change the capabilities. */
    capability = &obj->capability;

    capability->enable_soft_key_area = MMI_FALSE;
    capability->enable_center_soft_key = MMI_FALSE;

#if defined(__MMI_VUI_SHELL_MULTI_PAGE__)
    /*
     * Shell already has a touch button to lock the handset. No need to use END
     * key to lock the handset.
     */
    capability->enable_end_key = MMI_FALSE;
#endif /* defined(__MMI_VUI_SHELL_MULTI_PAGE__) */
}

#endif /* defined(__MMI_VUI_SHELL_APP__) */