Symbian Helloworld 分析

 

1. /*  
2.  ============================================================================  
3.  Name    : Helloworld.cpp  
4.  Author    : huzhangyou  
5.  Copyright   : Your copyright notice  
6.  Description : Exe source file  
7.  ============================================================================  
8.  */  
9.   
10. //  Include Files     
11.   
12. #include "Helloworld.h"   
13. #include <e32base.h>   
14. #include <e32std.h>   
15. #include <e32cons.h>      // Console   
16. //CConsoleBase类使用   
17.   
18. //  Constants   
19. //定义常量   
20. _LIT(KTextConsoleTitle, "Console");   
21. _LIT(KTextFailed, " failed, leave code = %d");   
22. _LIT(KTextPressAnyKey, " [press any key]/n");   
23.   
24.   
25. //  Global Variables   
26. //表示 LOCAL_C static   
27. //LOCAL_D static   
28. //定义静态CConsoleBase指针对象   
29. LOCAL_D CConsoleBase* console; // write all messages to this   
30.   
31.   
32. //  Local Functions   
33. //静态方法 MainL 主调函数 L表示可能会抛出异常   
34. LOCAL_C void MainL()   
35.   {   
36.   //   
37.   // add your program code here, example code below   
38.   //   
39.   console->Write(_L("Hello, world!/n"));   
40.   }   
41. //主调用MainL函数   
42. LOCAL_C void DoStartL()   
43.   {   
44.   // Create active scheduler (to run active objects)   
45. /*  
46. class CActiveScheduler : public CBase;  
47. Controls the handling of asynchronous requests as represented by active objects.  
49. An active scheduler is used to schedule the sequence in which active object request completion events are handled by a single event-handling thread.  
51. An active scheduler can be instantiated and used directly if either:  
53. the RunL() function of all of its active objects is guaranteed not to leave, or  
55. each of its active objects implements a suitable RunError() function to provide suitable cleanup  
57. If any of the active scheduler's active objects does not provide a RunError() function, then a CActiveScheduler derived class must be defined and an implementation of the Error() function provided to perform the cleanup required.  
59. There is one active scheduler per thread and the static functions provided by the class always refer to the current active scheduler.  
61. */  
62.   CActiveScheduler* scheduler = new (ELeave) CActiveScheduler();   
63. /*  
64. How to use the cleanup stack  
65. The cleanup stack is used as follows:   
67. Use CleanupStack::PushL() to push a pointer to the object onto the cleanup stack before any operation which might leave is performed   
69. Use CleanupStack::Pop() to pop the pointer from the cleanup stack when all operations that might leave have completed   
71. If a function leaves, then part of leave processing is to pop and destroy all objects on the cleanup stack. Thus, the cleanup stack may be used to prevent objects becoming orphaned if a leave occurs.   
73. */  
74.   CleanupStack::PushL(scheduler);   
75. /*  
76. static IMPORT_C void Install(CActiveScheduler *aScheduler);  
77. Description  
78. Installs the specified active scheduler as the current active scheduler.  
80. The installed active scheduler now handles events for this thread.  
82. The current active scheduler can be uninstalled by passing a NULL pointer.  
84. Parameters  
85. CActiveScheduler *aScheduler A pointer to the active scheduler to be installed. If this is NULL, the current active scheduler is uninstalled.  
86.    
87.    
89. Panic codes  
90. E32USER-CBase 43 if If there is already an installed active scheduler.  
91. */  
92.   CActiveScheduler::Install(scheduler);   
93. //调用 主执行函数   
94.   MainL();   
95.   
96.   // Delete active scheduler   
97. /*  
98. Description  
99. Constructs and pushes a TCleanupItem object onto the cleanup stack.  
101. The TCleanupItem encapsulates:  
103. the pointer aPtr to the object of type class T which is to be cleaned up  
105. an associated cleanup operation.  
107. The cleanup operation is the private static function Delete() of the templated class CleanupDelete, and is called as a result of a subsequent call to CleanupStack::PopAndDestroy().  
109. CleanupDelete::Delete() is passed a pointer to the class T object to be cleaned up, and the function implements cleanup by deleting the passed object.  
111. */  
112.   CleanupStack::PopAndDestroy(scheduler);   
113.   }   
114.   
115. //  Global Functions   
116. //主函数入口点   
117. GLDEF_C TInt E32Main()   
118.   {   
119.   // Create cleanup stack   
120. /*  
121. Marks the start of checking the current thread's heap.  
123. This macro is defined only for debug builds.  
125. This macro must be matched by a corresponding call to __UHEAP_MARKEND or __UHEAP_MARKENDC.  
127. Calls to this macro can be nested but each call must be matched by corresponding call to __UHEAP_MARKEND or __UHEAP_MARKENDC.  
128. */  
129.   __UHEAP_MARK;   
130. /*  
131. Cleanup stack interface.  
133. The creation and destruction of a cleanup stack is done automatically by GUI applications and servers.   
134. */  
135.   CTrapCleanup* cleanup = CTrapCleanup::New();   
136.   
137.   // Create output console   
138.   TRAPD(createError, console = Console::NewL(KTextConsoleTitle, TSize(KConsFullScreen,KConsFullScreen)));   
139.   if (createError)   
140.   return createError;   
141.   
142.   // Run application code inside TRAP harness, wait keypress when terminated   
143.   TRAPD(mainError, DoStartL());   
144. //如果出错 输出错误信息   
145.   if (mainError)   
146.   console->Printf(KTextFailed, mainError);   
147. //输出press any key   
148.   console->Printf(KTextPressAnyKey);   
149. //等待用户输入之后退出   
150.   console->Getch();   
151. //释放资源   
152.   delete console;   
153.   delete cleanup;   
154. //清理堆栈   
155.   __UHEAP_MARKEND;   
156.   return KErrNone;   
157.   }