ZeroC Ice 3.7.3 源码与中文教程.rar

1. Ice Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.1 Ice Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

1.1.1 Ice Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

1.1.1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

1.1.1.2 Slice (Specification Language for Ice) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

1.1.1.3 Overview of the Language Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

1.2.2 Writing an Ice Application with C++ (C++11) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

1.2.3 Writing an Ice Application with C++ (C++98) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

1.2.4 Writing an Ice Application with C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

1.2.5 Writing an Ice Application with Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

1.2.6 Writing an Ice Application with Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

1.2.7 Writing an Ice Application with JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

1.2.8 Writing an Ice Application with MATLAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

1.2.9 Writing an Ice Application with Objective-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

1.2.10 Writing an Ice Application with PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

1.2.11 Writing an Ice Application with Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

1.3.5 Basic Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

1.3.6 User-Defined Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

1.3.6.1 Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

1.3.6.2 Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

1.3.6.3 Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

1.3.6.4 Dictionaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

1.3.7 Constants and Literals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

1.3.8 Interfaces, Operations, and Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

1.3.8.1 Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

1.3.8.2 User Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

1.3.9.3 Class Inheritance Semantics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

1.3.9.4 Classes as Unions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

1.3.9.5 Self-Referential Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

1.3.9.6 Classes Versus Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

1.3.9.7 Classes with Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

1.3.9.8 Classes Implementing Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

1.3.9.9 Class Inheritance Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

1.3.9.10 Pass-by-Value Versus Pass-by-Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

1.3.9.11 Passing Interfaces by Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

1.3.9.12 Classes with Compact Type IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

1.3.15 Names and Scoping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

1.3.16 Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

1.3.17 Serializable Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

1.3.18 Deprecating Slice Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

1.3.19 Using the Slice Compilers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

1.3.20 Slice Checksums . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

1.3.21 Generating Slice Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

1.3.22 Slice Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

1.3.23 Slice Metadata Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

1.3.24 Slice for a Simple File System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

1.4.1.1 Selecting the C++11 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

1.4.1.2 Initialization and CommunicatorHolder in C++11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

1.4.1.3 Client-Side Slice-to-C++11 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

1.4.1.3.1 C++11 Mapping for Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

1.4.1.3.2 C++11 Mapping for Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

1.4.1.3.3 C++11 Mapping for Built-In Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

1.4.1.3.10 C++11 Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

1.4.1.3.11 C++11 Mapping for Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

1.4.1.3.12 C++11 Mapping for Optional Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

1.4.1.3.13 C++11 Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

1.4.1.3.14 Asynchronous Method Invocation (AMI) in C++11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

1.4.1.3.15 Using Slice Checksums in C++11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

1.4.1.3.16 Example of a File System Client in C++11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

1.4.1.4 Server-Side Slice-to-C++11 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

1.4.1.4.1 Server-Side C++11 Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

1.4.1.4.2 Parameter Passing in C++11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

1.4.1.5.2 C++11 Mapping for Local Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

1.4.1.5.3 C++11 Mapping for Local Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

1.4.1.5.4 C++11 Mapping for Operations on Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

1.4.1.5.5 C++11 Mapping for Data Members in Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

1.4.1.6 Customizing the C++11 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

1.4.1.6.1 The C++11 Stream Helpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

1.4.1.6.2 The cpp:type and cpp:view-type Metadata Directives with C++11 . . . . . . . . . . . . . . . . . . . . . . . . 353

1.4.1.7 Version Information in C++11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367

1.4.1.8 slice2cpp Command-Line Options (C++11) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

1.4.1.9 C++11 Strings and Character Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

1.4.1.9.7 The C++11 Ice String Converter Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

1.4.1.9.8 Custom String Converter Plug-ins with C++11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

1.4.1.10 C++11 Helper Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

1.4.2 C++98 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

1.4.2.1 Selecting the C++98 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

1.4.2.2 Initialization and CommunicatorHolder in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

1.4.2.3 Client-Side Slice-to-C++98 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

1.4.2.3.1 C++98 Mapping for Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

1.4.2.3.2 C++98 Mapping for Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

1.4.2.3.3 C++98 Mapping for Built-In Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

1.4.2.3.10 C++98 Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

1.4.2.3.11 C++98 Mapping for Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

1.4.2.3.12 C++98 Mapping for Optional Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442

1.4.2.3.13 C++98 Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

1.4.2.3.14 Smart Pointers for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

1.4.2.3.15 Asynchronous Method Invocation (AMI) in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467

1.4.2.3.16 Using Slice Checksums in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481

1.4.2.3.17 Example of a File System Client in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482

1.4.2.4 Server-Side Slice-to-C++98 Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

1.4.2.4.1 Server-Side C++98 Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489

1.4.2.4.4 Object Incarnation in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

1.4.2.4.5 Asynchronous Method Dispatch (AMD) in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

1.4.2.4.6 Example of a File System Server in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508

1.4.2.5 Slice-to-C++98 Mapping for Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

1.4.2.5.1 C++98 Mapping for Local Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

1.4.2.5.2 C++98 Mapping for Local Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

1.4.2.7 Version Information in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561

1.4.2.8 slice2cpp Command-Line Options (C++98) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

1.4.2.9 C++98 Strings and Character Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

1.4.2.9.1 Installing String Converters with C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564

1.4.2.9.2 UTF-8 Conversion with C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

1.4.2.9.3 String Parameters in Local C++98 Calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568

1.4.2.9.4 Built-in String Converters in C++98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

1.4.2.9.5 C++98 String Conversion Convenience Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

1.4.2.9.6 The C++98 iconv String Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571

1.4.2.9.7 The C++98 Ice String Converter Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

1.4.2.10.5 The C++ Shared and SimpleShared Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622

1.4.2.10.6 The C++ Time Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623

1.4.2.10.7 The C++ Timer and TimerTask Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627

1.4.3 C-Sharp Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629

1.4.3.1 Initialization in C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630

1.4.3.2 Client-Side Slice-to-C-Sharp Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633

1.4.3.2.1 C-Sharp Mapping for Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634

1.4.3.2.2 C-Sharp Mapping for Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635

1.4.3.2.3 C-Sharp Mapping for Built-In Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637

1.4.3.2.4 C-Sharp Mapping for Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638

1.4.3.2.11 C-Sharp Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663

1.4.3.2.12 C-Sharp Mapping for Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672

1.4.3.2.13 C-Sharp Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680

1.4.3.2.14 C-Sharp Mapping for Optional Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690

1.4.3.2.15 Serializable Objects in C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692

1.4.3.2.16 C-Sharp Attribute Metadata Directive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694

1.4.3.2.17 Asynchronous Method Invocation (AMI) in C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

1.4.3.2.18 slice2cs Command-Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720

1.4.3.2.19 Using Slice Checksums in C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721

1.4.3.2.20 Example of a File System Client in C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722

1.4.3.3.6 Asynchronous Method Dispatch (AMD) in C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748

1.4.3.3.7 Example of a File System Server in C-Sharp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757

1.4.3.4 Slice-to-C-Sharp Mapping for Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 768

1.4.3.4.1 C-Sharp Mapping for Local Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769

1.4.3.4.2 C-Sharp Mapping for Local Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771

1.4.3.4.3 C-Sharp Mapping for Local Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773

1.4.3.4.4 C-Sharp Mapping for Operations on Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775

1.4.3.4.5 C-Sharp Mapping for Data Members in Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

1.4.3.5 The .NET Utility Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777

1.4.4 Java Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779

1.4.4.3 Client-Side Slice-to-Java Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784

1.4.4.3.1 Java Mapping for Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785

1.4.4.3.2 Java Mapping for Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786

1.4.4.3.3 Java Mapping for Built-In Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787

1.4.4.3.4 Java Mapping for Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788

1.4.4.3.5 Java Mapping for Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791

1.4.4.3.12 Java Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 823

1.4.4.3.13 Java Mapping for Optional Data Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 830

1.4.4.3.14 Serializable Objects in Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832

1.4.4.3.15 Customizing the Java Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 834

1.4.4.3.16 Asynchronous Method Invocation (AMI) in Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845

1.4.4.3.17 Using the Slice Compiler for Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 854

1.4.4.3.18 slice2java Command-Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855

1.4.4.3.19 Using Slice Checksums in Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856

1.4.4.3.20 Example of a File System Client in Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 857

1.4.4.4 Server-Side Slice-to-Java Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862

1.4.4.5 Slice-to-Java Mapping for Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896

1.4.4.5.1 Java Mapping for Local Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 897

1.4.4.5.2 Java Mapping for Local Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899

1.4.4.5.3 Java Mapping for Local Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 901

1.4.4.5.4 Java Mapping for Operations on Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903

1.4.4.5.5 Java Mapping for Data Members in Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905

1.4.4.6 The Util Class in Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 906

1.4.4.7 Custom Class Loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907

1.4.4.8 Java Interrupts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 908

1.4.5 Java Compat Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 911

1.4.5.3.4 Java Compat Mapping for Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 919

1.4.5.3.5 Java Compat Mapping for Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922

1.4.5.3.6 Java Compat Mapping for Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925

1.4.5.3.7 Java Compat Mapping for Dictionaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 926

1.4.5.3.8 Java Compat Mapping for Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 927

1.4.5.3.9 Java Compat Mapping for Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 929

1.4.5.3.10 Java Compat Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934

1.4.5.3.11 Java Compat Mapping for Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944

1.4.5.3.12 Java Compat Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953

1.4.5.3.13 Java Compat Mapping for Optional Data Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 961

1.4.5.4 Server-Side Slice-to-Java Compat Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 998

1.4.5.4.1 Server-Side Java Compat Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 999

1.4.5.4.2 Parameter Passing in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003

1.4.5.4.3 Raising Exceptions in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009

1.4.5.4.4 Tie Classes in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1011

1.4.5.4.5 Object Incarnation in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1015

1.4.5.4.6 Asynchronous Method Dispatch (AMD) in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019

1.4.5.4.7 Example of a File System Server in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024

1.4.5.5 Slice-to-Java Compat Mapping for Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035

1.4.5.5.1 Java Compat Mapping for Local Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036

1.4.5.5.4 Java Compat Mapping for Operations on Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042

1.4.5.5.5 Java Compat Mapping for Data Members in Local Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043

1.4.5.6 The Util Class in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044

1.4.5.7 Custom Class Loaders in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1045

1.4.5.8 Handling Interrupts in Java Compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1046

1.4.6 JavaScript Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1049

1.4.6.2.5 JavaScript Mapping for Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1062

1.4.6.2.6 JavaScript Mapping for Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1064

1.4.6.2.7 JavaScript Mapping for Dictionaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065

1.4.6.2.8 JavaScript Mapping for Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1068

1.4.6.2.9 JavaScript Mapping for Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1070

1.4.6.2.10 JavaScript Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1073

1.4.6.2.11 JavaScript Mapping for Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1081

1.4.6.2.12 JavaScript Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1089

1.4.6.2.13 slice2js Command-Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1095

1.4.6.3 Server-Side Slice-to-JavaScript Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1096

1.4.6.4.1 JavaScript Mapping for Local Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1111

1.4.6.4.2 JavaScript Mapping for Local Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1113

1.4.7 MATLAB Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115

1.4.7.1 Initialization in MATLAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1116

1.4.7.2 Client-Side Slice-to-MATLAB Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1117

1.4.7.2.1 MATLAB Mapping for Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1118

1.4.7.2.2 MATLAB Mapping for Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1119

1.4.7.2.3 MATLAB Mapping for Basic Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120

1.4.7.2.4 MATLAB Mapping for Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1121

1.4.7.2.5 MATLAB Mapping for Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1124

1.4.7.2.12 MATLAB Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1153

1.4.7.2.13 Asynchronous Method Invocation (AMI) in MATLAB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1159

1.4.7.2.14 slice2matlab Command-Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1163

1.4.8 Objective-C Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1164

1.4.8.1 Initialization in Objective-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1165

1.4.8.2 Client-Side Slice-to-Objective-C Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1167

1.4.8.2.1 Objective-C Mapping for Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1168

1.4.8.2.2 Objective-C Mapping for Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1170

1.4.8.2.3 Objective-C Mapping for Built-In Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1172

1.4.8.2.4 Objective-C Mapping for Enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1173

1.4.8.2.11 Objective-C Mapping for Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1201

1.4.8.2.12 Objective-C Mapping for Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1213

1.4.8.2.13 Objective-C Mapping for Interfaces by Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1222

1.4.8.2.14 Objective-C Mapping for Optional Data Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223

1.4.8.2.15 Asynchronous Method Invocation (AMI) in Objective-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1224

1.4.8.2.16 slice2objc Command-Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1233

1.4.8.2.17 Example of a File System Client in Objective-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1234

1.4.8.3 Server-Side Slice-to-Objective-C Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1240

1.4.8.3.1 Server-Side Objective-C Mapping for Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1241

1.4.8.3.2 Parameter Passing in Objective-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1245