Table of Contents

---

XBinder Overview 1

Using XBinder 2

Running XBinder from the Command-line 2

Compiling and Linking Generated Code 8

Getting Started with C or C++ Sample Programs 10

Getting Started with your own XML Schema 11

Generated C/C++ Source Code 13

Header (.h) File 13

C Code Generated for XSD Types 13

C Code Generated for XSD Global Elements 15

C++ Code Generated for XSD Types 16

C++ Code Generated for XSD Global Elements 16

Namespace Considerations 17

XSD Simple Type to C/C++ Type Mappings 19

Character String Types 21

Enumerated Type 22

Real Number Types 25

Binary String Types 26

Dynamic Case (no length facet): 27

Static Case (length restricted to 32K or less): 27

Date/Time Types 28

Boolean Type 29

Union Type 29

List Type 31

XSD Complex Type to C/C++ Type Mappings 33

SEQUENCE 33

Optional Elements 34

Repeating Elements 35

Nested Types 38

Any Element 40

ALL 41

CHOICE 41

Generated C++ Get/Set Methods 43

Substitution Groups 46

Attributes 48

ComplexContent 50

Element Extension 50

Attribute Extension 52

Restrictions 53

SimpleContent 54

Extensions 55

Restrictions 56

Group 56

Configuration File 59

Binding Language 59

Binding Declaration 59

Version Attribute 60

Configuration File Language Overview 60

Global <bindings> Declaration 61

<schemaBindings> Declaration 62

<nodeBindings> Declaration 64

Advanced XML Names Transformation 66

Configuration File Example 69

Generated C Encode/Decode Functions 71

Preparing C Data Variables for Encoding 71

Dynamic Memory Management 71

Populating Generated Structure Variables for Encoding 72

Accessing Encoded Message Components 73

Generated XML Encode Functions 74

Generated C Function Format and Calling Parameters 74

Generated C Encode Functions for Global Elements 75

Procedure for Calling a Generated C Encode Function 75

Generated XML Decode Functions 79

Generated C Function Format and Calling Parameters 79

Procedure for Calling C Decode Functions 80

Generated Validation Functions 82

Procedure for Calling C Validation Functions 83

Generated Print Functions 85

Generated Test Functions 86

Other Generated Functions 87

Initialization Functions 87

Memory Free Functions 88

Helper Functions 88

Generated Makefile 89

Generated C++ Class Methods 91

Preparing C++ Objects for Encoding 91

Dynamic Memory Management 91

Populating Generated Class Instances for Encoding 92

Generated XML C++ Encode Methods 96

Generated Method Format and Calling Parameters 96

Generated C++ Encode Methods for Global Elements 97

Procedure for Using the Generated C++ Encode Method 97

Generated XML C++ Decode Methods 98

Generated C++ Method Format and Calling Parameters 99

Procedure for Calling C++ Decode Methods 100

Generated XML C++ Validation Methods 102

Generated C++ Method Format and Calling Parameters 102

Procedure for Calling C++ Validation Methods 102

XBinder C Runtime Library 105

XML Run-time Library Functions 106

XML C Encode Functions 106

XML C Decode Functions 107

XML C Parser Interface 107

Expat 108

LibXML2 108

C Common Runtime Library 109

Common Include Files 109

rtxSysTypes.h 109

rtxCommon.h 110

rtxContext.h 110

Context Management Functions 112

UTF-8 String Functions 113

Doubly-Linked List Utility Functions 113

Error Formatting and Print Functions 114

Diagnostic trace functions 114

Input/Output Data Stream Utility Functions 115

TCP/IP or UDP socket utility functions 116

SOAP and HTTP utility functions 116

C++ Built-in Runtime Classes 117

Message Buffer Classes 117

Global Element Base Class 118

XSD Type Base Classes 118

XML Parser Interface Classes 119

INDEX 121