Table of Contents

There is also a listing of tables, figures, and captioned examples.

Part I: Advanced Tools Module

Chapter 1: Introduction

• 1.1 Welcome
• 1.2 Product Packages and Libraries
• 1.3 Examples
• 1.4 Products and Services Information

Chapter 2: Package Overview

• 2.1 Advanced Tools Module Packages
• 2.1.1 The Streams Package
• 2.1.2 The Serialization Package
• 2.1.3 The Types Package
• 2.2 Using the Packages Together
• 2.3 Introduction to the Handle-Body Architecture

Part II: Advanced Tools Module Packages

Chapter 3: The Streams Package

• 3.1 Introducing the Streams Package
• 3.2 The Stream Families
• 3.2.1 Memory Streams
• 3.2.2 Interpackage Dependencies
• 3.3 Definitions
• 3.4 Streams Package Architecture
• 3.4.1 The Common Framework
• 3.4.1.1 The Handle Classes
• 3.4.1.2 The Abstract Body Classes
• 3.4.2 The Extended Framework
• 3.4.2.1 The Memory Stream Handle Classes
• 3.4.2.2 The Memory Stream Abstract Body Classes
• 3.4.2.3 The Memory Stream Concrete Body Classes
• 3.4.3 The Common Filtered Streams
• 3.4.3.1 Buffered Streams
• 3.4.3.2 Synchronized Streams
• 3.4.3.3 Guarded Streams
• 3.5 The Streams Package Classes
• 3.5.1 The Binary Streams
• 3.5.1.1 The RWByteToStreambufOutputStreamImp Class
• 3.5.1.2 The RWByteFromStreambufInputStreamImp Class
• 3.5.1.3 The RWStreambufToByteOutputStream Class
• 3.5.1.4 The RWStreambufFromByteInputStream Class
• 3.5.2 The Narrow Character Streams
• 3.5.2.1 The RWCharToStreambufOutputStreamImp Class
• 3.5.2.2 The RWCharFromStreambufInputStreamImp Class
• 3.5.2.3 The RWStreambufToCharOutputStream Class
• 3.5.2.4 The RWStreambufFromCharInputStream Class
• 3.5.3 The Unicode Character Streams
• 3.5.3.1 The RWUCharToByteOutputStreamImp Class
• 3.5.3.2 The RWUCharFromByteInputStreamImp Class
• 3.5.3.3 The RWUCharToUTF8ByteOutputStreamImp Class
• 3.5.3.4 The RWUCharFromUTF8ByteInputStreamImp Class
• 3.5.4 The Wide Character Streams
• 3.5.4.1 The RWWCharToWStreambufOutputStreamImp Class
• 3.5.4.2 The RWWCharFromWStreambufInputStreamImp Class
• 3.5.5 The Data Streams
• 3.5.5.1 The RWNativeDataToByteOutputStreamImp Class
• 3.5.5.2 The RWNativeDataFromByteInputStreamImp Class
• 3.5.5.3 The RWOstreamDataToCharOutputStreamImp Class
• 3.5.5.4 The RWIstreamDataFromCharInputStreamImp Class
• 3.5.5.5 The RWvostreamToDataOutputStream Class
• 3.5.5.6 The RWvistreamFromDataInputStream Class

Chapter 4: Using Streams

• 4.1 Introduction
• 4.1.1 The Streams Header Files
• 4.1.2 Using the Streams Package with Other Streaming Libraries
• 4.1.2.1 Using the Standard iostreams Library
• 4.1.2.2 Using Essential Tools Module Virtual Streams
• 4.2 Examples
• 4.2.1 Creating and Using Streams with Only One Streaming Element
• 4.2.2 Creating and Using Chains of Streaming Elements
• 4.2.2.1 Output Example
• 4.2.2.2 Input Example
• 4.2.3 Creating and Using Thread-safe Chains of Streaming Elements
• 4.2.3.1 Creating a Synchronized Data Output Stream
• 4.2.3.2 Creating and Managing Threads Using Active Objects
• 4.2.3.3 Creating and Sharing a Synchronized Data Output Stream Among Several Active Objects
• 4.2.3.4 Active Objects and Data Input Streams
• 4.2.3.5 Creating and Sharing a Synchronized Data Input Stream Among Several Active Objects
• 4.2.4 Creating and Using Stream Adapter Classes in the Advanced Tools Module
• 4.2.4.1 The iostreams Adapter Classes
• 4.2.4.2 Virtual Streams Adapter Classes in the Essential Tools Module
• 4.2.4.3 Architecture of the Adapter Classes
• 4.2.4.4 Using the Adapter Classes for Output
• 4.2.4.5 Using the Adapter Classes for Input
• 4.3 Error Handling
• 4.3.1 Handling Errors Using the Stream Status Functions
• 4.3.2 Streams Package Exception Classes

Chapter 5: The Serialization Package

• 5.1 Introducing the Serialization Package
• 5.1.1 Classes Supported by the Serialization Package
• 5.1.2 Object Serialization for Saving Program State
• 5.1.3 Object Serialization and Distributed Applications
• 5.1.4 Interpackage Dependencies
• 5.2 Object Serialization Concepts
• 5.2.1 Writing and Reading the Object State
• 5.2.2 Type Information (Polymorphism)
• 5.2.3 Object Identity (Isomorphism)
• 5.2.4 Intrusive and External Serialization
• 5.2.5 Symmetry of Object Input and Output
• 5.2.6 Annotated Streams and Embedded Schemas
• 5.3 Supported Streaming Formats
• 5.3.1 The Compact Object Stream Format
• 5.3.1.1 Object Streams With Data Streams
• 5.3.1.2 Object Streams With Virtual Streams
• 5.3.1.3 Object Streams With Collectable Objects
• 5.4 Serialization Package Architecture
• 5.4.1 How Does Serialization Work?
• 5.4.2 Relationship to the Streams Package
• 5.4.3 Handle-Body Architecture
• 5.5 Serialization Package Classes

Chapter 6: Using Object Serialization

• 6.1 Introduction
• 6.1.1 Including the Header Files
• 6.2 Getting Started
• 6.2.1 Serialization Requirements
• 6.2.2 Simple Examples
• 6.2.2.1 Declaring the Streaming Operators
• 6.2.2.2 Defining the streamContents() Function
• 6.2.2.3 Streaming the Serialized Object
• 6.2.2.4 Writing to and Reading from Compact Object Streams
• 6.2.2.5 Writing to and Reading from Compact Object Streams With Virtual Streams
• 6.3 Using the Stream Contents Macros
• 6.3.1 Header File Macros
• 6.3.2 Source File Macros
• 6.3.3 Macros for External Serialization
• 6.3.4 Macro Summary
• 6.4 Basic Examples
• 6.4.1 Saving and Restoring an Object by Value
• 6.4.1.1 First Change
• 6.4.1.2 Second Change
• 6.4.2 Saving and Restoring an Object by Pointer
• 6.4.2.1 First Change
• 6.4.2.2 Second Change
• 6.4.2.3 Third Change
• 6.4.2.4 A Caution on Using Streaming Pointers
• 6.4.3 Associations with Other Objects
• 6.4.3.1 Data Member is an Object
• 6.4.3.2 Data Member is a Pointer to an Object
• 6.4.3.3 Data Member is a Value-based or Pointer-based Collection
• 6.4.4 Templates
• 6.4.5 Default Constructors
• 6.4.6 External Serialization
• 6.4.7 External Serialization of Templates and Nested Classes
• 6.5 Advanced Examples
• 6.5.1 Using Object Streams with RWCollectable-Derived Objects
• 6.5.2 Making RWCollectable Objects That Are Also Serializable
• 6.5.3 Writing Custom streamContents() Functions
• 6.5.4 Controlling the Scope of Object Reference Resolution
• 6.5.4.1 Streaming Out Multiple Objects
• 6.5.4.2 Streaming Multiple Objects into One Document

Chapter 7: The Types Package

• 7.1 Introducing the Types Package

Chapter 8: International Features of the Advanced Tools Module

• 8.1 Introduction
• 8.1.1 An Introduction to Unicode
• 8.2 Determining your Character Encoding Needs
• 8.2.1 The Advanced Tools Module's Character Encoding Requirements
• 8.2.2 When You Do Not Need the Internationalization Module
• 8.2.3 When You Do Need the Internationalization Module
• 8.2.4 Choosing the Appropriate String Class
• 8.3 International Features of the Streams Package
• 8.3.1 Using the Streams Package without the Internationalization Module
• 8.3.1.1 Unicode-Based Stream Classes
• 8.3.1.2 Unicode Converter Classes
• 8.3.1.3 Example
• 8.3.2 Using the Streams Package with the Internationalization Module
• 8.4 International Features of the Serial Package
• 8.4.1 Using the Serial Package without the Internationalization Module
• 8.4.1.1 Compact Object Streams
• 8.4.2 Using the Serial Package with the Internationalization Module
• 8.4.2.1 Converting from a Local Encoding to UTF-16
• 8.4.2.2 Converting from UTF-16 to a Local Encoding

Part III: Appendices

Appendix A: Bibliography

• A.1 Introduction
• A.2 The C++ Language
• A.2.1 Books
• A.2.2 Magazines and Articles
• A.3 Object-Oriented Design
• A.3.1 Books
• A.3.2 Magazines and Articles
• A.3.3 Web Sites

Topic Index

© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.