Symbian OS Explained. Effective C++ Programming For Smartphones

Team-kB......Page 1
Contents......Page 8
1.1 Fundamental Types......Page 30
1.2 T Classes......Page 32
1.3 C Classes......Page 33
1.4 R Classes......Page 35
1.5 M Classes......Page 36
1.7 Buyer Beware......Page 40
1.8 Summary......Page 41
2.1 Leaving Functions......Page 42
2.2 Heap Allocation Using  new ( ELeave)......Page 45
2.3 Constructors and Destructors......Page 46
2.4 Working with Leaving Functions......Page 47
2.5 Trapping a Leave Using TRAP and  TRAPD......Page 49
2.6 LeaveScan......Page 55
2.7 Summary......Page 56
3 The Cleanup Stack......Page 58
3.1 Using the Cleanup Stack......Page 60
3.2 How Does the Cleanup Stack Work?......Page 64
3.3 Using the Cleanup Stack with Non- CBase Classes......Page 67
3.4 Using  TCleanupItem for Customized Cleanup......Page 73
3.6 An Incidental Note on the Use of Casts......Page 75
3.7 Summary......Page 76
4 Two- Phase Construction......Page 78
5 Descriptors: Symbian OS Strings......Page 84
5.1 Non-Modifiable Descriptors......Page 85
5.2 Modifiable Descriptors......Page 87
5.3 Pointer Descriptors......Page 89
5.4 Stack-Based Buffer Descriptors......Page 92
5.5 Heap-Based Buffer Descriptors......Page 94
5.6 Literal Descriptors......Page 98
5.7 Summary......Page 101
6.1 Descriptors as Parameters and Return Types......Page 104
6.2 Common Descriptor Methods......Page 107
6.3 The Use of  HBufC Heap Descriptors......Page 111
6.4 Externalizing and Internalizing Descriptors......Page 113
6.5 The Overuse of  TFileName......Page 115
6.6 Useful Classes for Descriptor Manipulation......Page 116
6.7 Summary......Page 117
7 Dynamic Arrays and Buffers......Page 120
7.1 CArrayX Classes......Page 121
7.2 RArray< class T> and  RPointerArray< class T>......Page 126
7.3 Why Use  RArray Instead of CArrayX?......Page 131
7.4 Dynamic Descriptor Arrays......Page 132
7.5 Fixed-Length Arrays......Page 133
7.6 Dynamic Buffers......Page 135
7.7 Summary......Page 138
8.1 Multitasking Basics......Page 140
8.2 Event-Driven Multitasking......Page 141
8.3 Working with Active Objects......Page 144
8.4 Example Code......Page 149
8.6 Application Code and Active Objects......Page 152
8.7 Summary......Page 153
9 Active Objects under the Hood......Page 156
9.1 Active Object Basics......Page 157
9.2 Responsibilities of an Active Object......Page 160
9.3 Responsibilities of an Asynchronous Service Provider......Page 162
9.4 Responsibilities of the Active Scheduler......Page 163
9.6 Nesting the Active Scheduler......Page 164
9.7 Extending the Active Scheduler......Page 165
9.8 Cancellation......Page 166
9.10 State Machines......Page 167
9.11 Long-Running Tasks......Page 172
9.12 Class  CIdle......Page 175
9.13 Class  CPeriodic......Page 177
9.14 Common Mistakes......Page 178
9.15 Summary......Page 179
10 Symbian OS Threads and Processes......Page 180
10.1 Class  RThread......Page 181
10.2 Thread Priorities......Page 184
10.3 Stopping a Running Thread......Page 186
10.4 Inter-Thread Data Transfer......Page 191
10.5 Exception Handling......Page 192
10.6 Processes......Page 193
10.7 Summary......Page 195
11 The Client– Server Framework in Theory......Page 196
11.2 How Do the Client and Server Fit Together?......Page 197
11.4 What Classes Does the Client– Server Framework Use?......Page 199
11.6 How Is a Server Started?......Page 208
11.8 What Happens When a Client Disconnects?......Page 209
11.11 How Does Client– Server Communication Use Threads?......Page 210
11.13 What Are the Advantages of a Local (Same-Process) Server?......Page 211
11.14 What Are the Overheads of Client– Server Communication?......Page 212
11.17 Example Code......Page 215
11.18 Summary......Page 216
12 The Client– Server Framework in Practice......Page 218
12.1 Client– Server Request Codes......Page 219
12.2 Client Boilerplate Code......Page 220
12.3 Starting the Server and Connecting to It from the Client......Page 227
12.4 Server Startup Code......Page 232
12.5 Server Classes......Page 234
12.6 Server Shutdown......Page 242
12.8 Summary......Page 243
13.1 Symbian OS EXEs......Page 246
13.2 Symbian OS DLLs......Page 247
13.3 Writable Static Data......Page 249
13.4 Thread-Local Storage......Page 252
13.6 UIDs......Page 255
13.7 The  targettype Specifier......Page 257
13.8 Summary......Page 259
14.1 ECOM Architecture......Page 262
14.2 Features of an ECOM Interface......Page 265
14.3 Factory Methods......Page 266
14.4 Implementing an ECOM Interface......Page 269
14.5 Resource Files......Page 271
14.6 Example Client Code......Page 274
14.7 Summary......Page 275
15 Panics......Page 276
15.1 Just-In-Time Debugging......Page 277
15.2 Good Panic Style......Page 278
15.3 Symbian OS Panic Categories......Page 279
15.4 Panicking Another Thread......Page 280
15.6 Summary......Page 282
16 Bug Detection Using Assertions......Page 284
16.1 __ ASSERT_ DEBUG......Page 285
16.2 __ ASSERT_ ALWAYS......Page 290
16.3 Summary......Page 292
17.1 Heap-Checking Macros......Page 294
17.2 Object Invariance Macros......Page 299
17.3 Console Tests Using  RTest......Page 302
17.4 Summary......Page 305
18 Compatibility......Page 306
18.1 Forward and Backward Compatibility......Page 307
18.2 Source Compatibility......Page 308
18.3 Binary Compatibility......Page 309
18.4 Preventing Compatibility Breaks......Page 310
18.5 What Can I Change Without Breaking Binary Compatibility?......Page 316
18.6 Best Practice: Planning for Future Changes......Page 318
18.7 Compatibility and the Symbian OS Class Types......Page 320
18.8 Summary......Page 321
19 Thin Templates......Page 322
20 Expose a Comprehensive and Comprehensible API......Page 328
20.1 Class Layout......Page 329
20.2 IMPORT_ C and  EXPORT_ C......Page 330
20.3 Parameters and Return Values......Page 332
20.4 Member Data and Functional Abstraction......Page 338
20.5 Choosing Class, Method and Parameter Names......Page 341
20.6 Compiler-Generated Functions......Page 343
20.7 Summary......Page 344
21.1 Reduce the Size of Program Code......Page 346
21.2 Use Heap Memory Carefully......Page 349
21.3 Use Stack Memory Carefully......Page 354
21.4 Eliminate Sub-Expressions to Maximize Code Efficiency......Page 357
21.5 Optimize Late......Page 359
21.6 Summary......Page 360
Appendix Code Checklist......Page 362
Glossary......Page 368
Bibliography and Online Resources......Page 376
Index......Page 380