Generated Stream-Oriented C++ Encode Method Format and Calling Parameters

---

C++ code generation of stream-based encoders is selected by using the -c++ and -stream compiler command line options. In this case, ASN1C generates an EncodeTo method that wraps the C function call. This method provides a more simplified calling interface because it hides things such as the context structure and tag type parameters.

The calling sequence for the generated C++ class method is as follows:

    stat = <object>.EncodeTo (<outputStream>); 
 

In this definition, <object> is an instance of the control class (i.e., ASN1C_<prodName>) generated for the given production.

The <outputStream> placeholder represents an output stream object type. This is an object derived from an ASN1OutputStream class.

The function result variable stat returns the completion status. Error status codes are negative. Return status values are defined in the asn1type.h include file.

Another way to encode a message using the C++ classes is to use the << streaming operator:

    <outputStream> << <object>; 
 

In this case, the exception OSCStreamException could be thrown if an error occurs.

Also, the method Encode without parameters is supported for backward compatibility. In this case it is necessary to create control class (i.e., ASN1C_<prodName>) using an output stream reference as the first parameter and msgdata reference as the second parameter of the constructor.