[#BloombergLP-bdlde-CharConvertStatus]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlde.adoc[bdlde]::CharConvertStatus
:relfileprefix: ../../
:mrdocs:

This `struct` provides a namespace for enumerating the set of mask codes that can be used to interpret `int` return values from translation functions in `bdede`&period;

== Synopsis

Declared in `&lt;bdlde&lowbar;charconvertstatus&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct CharConvertStatus;
----

== Description

This class&colon; &ast; supports a complete set of _enumeration_ operations

* except for `bdex` serialization &ast; is `const` _thread&hyphen;safe_ For terminology see `bsldoc&lowbar;glossary`&period;

== Enums

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlde/CharConvertStatus/Enum.adoc[`Enum`] 
| Bit&hyphen;masks returned by character&hyphen;conversion functions to report conversion issues&period;
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlde/CharConvertStatus/print.adoc[`print`] 
| Write the string representation of the specified enumeration `value` to the specified output `stream`, and return a reference to `stream`&period; Optionally specify an initial indentation `level`, whose absolute value is incremented recursively for nested objects&period; If `level` is specified, optionally specify `spacesPerLevel`, whose absolute value indicates the number of spaces per indentation level for this and all of its nested objects&period; If `level` is negative, suppress indentation of the first line&period; If `spacesPerLevel` is negative, format the entire output on one line, suppressing all but the initial indentation (as governed by `level`)&period; See `toAscii` for what constitutes the string representation of a `CharConvertStatus&colon;&colon;Enum` value&period;
| xref:BloombergLP/bdlde/CharConvertStatus/toAscii.adoc[`toAscii`] 
| Return the non&hyphen;modifiable string representation corresponding to the specified enumeration `value`, if it exists, and a unique (error) string otherwise&period; The string representation of `value` matches its corresponding enumerator name with the &quot;k&lowbar;&quot; prefix elided&period; For example&colon; &grave; bsl&colon;&colon;cout &lt;&lt; CharConvertStatus&colon;&colon;toAscii( CharConvertStatus&colon;&colon;k&lowbar;OUT&lowbar;OF&lowbar;SPACE&lowbar;BIT)&semi; &grave; will print the following on standard output&colon; &grave; OUT&lowbar;OF&lowbar;SPACE&lowbar;BIT &grave; Note that specifying a `value` that does not match any of the enumerators will result in a string representation that is distinct from any of those corresponding to the enumerators, but is otherwise unspecified&period;
|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#
