CodingTemplate.c
上传用户:lqx1163
上传日期:2014-08-13
资源大小:9183k
文件大小:7k
源码类别:

MTK

开发平台:

C/C++

  1. /*****************************************************************************
  2. *  Copyright Statement:
  3. *  --------------------
  4. *  This software is protected by Copyright and the information contained
  5. *  herein is confidential. The software may not be copied and the information
  6. *  contained herein may not be used or disclosed except with the written
  7. *  permission of MediaTek Inc. (C) 2005
  8. *
  9. *  BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
  10. *  THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE")
  11. *  RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON
  12. *  AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES,
  13. *  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
  14. *  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
  15. *  NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
  16. *  SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
  17. *  SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH
  18. *  THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO
  19. *  NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S
  20. *  SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM.
  21. *
  22. *  BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
  23. *  LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
  24. *  AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
  25. *  OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO
  26. *  MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. 
  27. *
  28. *  THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE
  29. *  WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF
  30. *  LAWS PRINCIPLES.  ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND
  31. *  RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER
  32. *  THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC).
  33. *
  34. *****************************************************************************/
  35. /*****************************************************************************
  36.  *
  37.  * Filename:
  38.  * ---------
  39.  *  CodingTemplate.c
  40.  *
  41.  * Project:
  42.  * -------- 
  43.  *  MAUI
  44.  *
  45.  * Description:
  46.  * ------------
  47.  *  Coding Template header file
  48.  *
  49.  * Author:
  50.  * -------
  51.  * -------
  52.  *
  53.  *============================================================================
  54.  *             HISTORY
  55.  * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
  56.  *------------------------------------------------------------------------------
  57.  * removed!
  58.  *
  59.  * removed!
  60.  * removed!
  61.  * removed!
  62.  *
  63.  *------------------------------------------------------------------------------
  64.  * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
  65.  *============================================================================
  66.  ****************************************************************************/
  67. /*****************************************************************************
  68.  * FUNCTION
  69.  *  mmi_sample_code
  70.  * DESCRIPTION
  71.  *  Sample code
  72.  * PARAMETERS
  73.  *  void
  74.  * RETURNS
  75.  *  void
  76.  *****************************************************************************/
  77. void mmi_sample_code(void)
  78. {
  79.     /*----------------------------------------------------------------*/
  80.     /* Local Variables                                                */
  81.     /*----------------------------------------------------------------*/
  82.     S32 data1, data2;
  83.     S32 i, j;
  84.     /*----------------------------------------------------------------*/
  85.     /* Code Body                                                      */
  86.     /*----------------------------------------------------------------*/
  87.     /*
  88.      * [TOPIC] BLANK SPACE
  89.      * (1) Add a blank sapce after if/for/else/swtich, etc
  90.      * (2) Add a blank space befor and after binary operator
  91.      * (3) Add a blank space after semicolon(;)
  92.      */
  93.     if ((i < 10) || (j > 20))
  94.     {
  95.         return;
  96.     }
  97.     for (i = j - 1; i >= 0; i++)
  98.     {
  99.         return;
  100.     }
  101.     /*
  102.      * [TOPIC] BLANK SPACE
  103.      * (1) No blank space between function and following parenthesis
  104.      */
  105.     mmi_sample_code();
  106.     /*
  107.      * [TOPIC] SWITCH CASE
  108.      * (1) Add one blank space between each case 
  109.      * (2) If have bracket in case, put break inside (example's case 1)
  110.      * (3) Should add default handler
  111.      * (4) Indent refer to the following example
  112.      */
  113.     switch (i)
  114.     {
  115.         case 0:
  116.             data1 = 10;
  117.             break;
  118.         case 1:
  119.         {
  120.             S32 local_data = 20;
  121.             data1 = local_data;
  122.             break;
  123.         }
  124.         case 0:
  125.             data1 = 30;
  126.             break;
  127.         default:
  128.             /* shall not enter here */
  129.             MMI_ASSERT(0);
  130.             break;
  131.     }
  132.     /*
  133.      * [TOPIC] SPLIT LONG EXPRESSION
  134.      * (1) Align to proper indent
  135.      */
  136.     if ((g_mmi_cntx->data1 == NULL) && ((g_mmi_cntx->data2 == NULL) || (g_mmi_cntx->data3 == NULL)))
  137.     {
  138.         return;
  139.     }
  140.     for (curr = *listp, tail = listp; curr != NULL; tail = &(curr->next), curr = curr->next)
  141.     {
  142.     }
  143.     /*
  144.      * [TOPIC] SPLIT LONG FUNCTION
  145.      * (1) Parameter's align to the first tab from function's head
  146.      */
  147.     ret_value = mmi_this_is_a_very_long_function_name(
  148.                     MMI_TURE,
  149.                     g_mmi_cntx.theme.scrollbar.position,
  150.                     g_mmi_cntx.theme.scrollbar.rect,
  151.                     g_mmi_cntx.theme.scrollbar.color);
  152.     long_ret_value_name
  153.         = mmi_this_is_a_very_long_function_name(
  154.             MMI_TURE,
  155.             g_mmi_cntx.theme.scrollbar.position,
  156.             g_mmi_cntx.theme.scrollbar.rect,
  157.             g_mmi_cntx.theme.scrollbar.color);
  158. }
  159. /*****************************************************************************
  160.  * FUNCTION
  161.  *  mmi_sample_function
  162.  * DESCRIPTION
  163.  *  Your description
  164.  * PARAMETERS
  165.  *  var_1           [IN]            Description of var_1
  166.  *  var_2_ptr       [OUT]           Description of var_2_ptr
  167.  *  var_3_ptr       [IN/OUT]        Description of var_3_ptr
  168.  * RETURNS
  169.  *  You description of return value
  170.  * RETURN VALUE LIST
  171.  *  MMI_RETURN_1     Description of return_1
  172.  *  MMI_RETURN_2     Description of return_2
  173.  *  MMI_RETURN_3     Description of return_3
  174.  *****************************************************************************/
  175. U16 mmi_sample_function(U16 var_1, U16 *var_2_ptr, U16 *var_3_ptr)
  176. {
  177.     /*----------------------------------------------------------------*/
  178.     /* Local Variables                                                */
  179.     /*----------------------------------------------------------------*/
  180.     /* Write your local var declare here */
  181.     /*----------------------------------------------------------------*/
  182.     /* Code Body                                                      */
  183.     /*----------------------------------------------------------------*/
  184.     /* Write your code here */
  185. }