| DEPRECATED: | Since Creo 3 | ||||||||||
| SUPERSEDED BY: | No successor will be provided. | ||||||||||
| Description | |||||||||||
| Converts a Creo Parametric UNICODE-encoded multibyte string to the legacy encoding used by Pro/ENGINEER prior to Wildfire 4.0. Use this function when you need to use a string obtained from Creo Parametric to a file which might need to be read by Creo Parametric or a Creo Parametric TOOLKIT application running in an older version of Pro/E.
The resulting string will always be NULL-terminated as long as the result buffer has sufficient space for this. |
|||||||||||
| Synopsis | |||||||||||
| #include <ProUtil.h> | |||||||||||
| ProError | ProStringToLegacystring | ( | |||||||||
| char* result | |||||||||||
| /* (Out) | |||||||||||
| The legacy-encoded string. The application must provide enough memory for this output. | |||||||||||
| */ | |||||||||||
| int result_size | |||||||||||
| /* (In) | |||||||||||
| The size of the buffer supplied for conversion. | |||||||||||
| */ | |||||||||||
| char* input | |||||||||||
| /* (In) | |||||||||||
| The Creo Parametric string. | |||||||||||
| */ | |||||||||||
| int input_size | |||||||||||
| /* (In) | |||||||||||
| The size of the input widestring supplied for conversion. If this is PRO_VALUE_UNUSED, the entire input string should be converted. | |||||||||||
| */ | |||||||||||
| char out_of_encoding_char | |||||||||||
| /* (In) | |||||||||||
| The character to use when the conversion encounters an out-of-encoding character in the input. | |||||||||||
| */ | |||||||||||
| ProBoolean* out_of_encoding | |||||||||||
| /* (Out) | |||||||||||
| Flag indicating if the out-of-encoding character was used during the conversion process. | |||||||||||
| */ | |||||||||||
| ) | |||||||||||
| Returns | |||||||||||
|
|||||||||||