Returns a textual representation of the quality.
Syntax
QualityToStr(QUALITY quality, INT part, INT localized)
quality:
Specifies the QUALITY variable.
part:
Specifies the part of quality to obtain the textual representation.
-2: Short representation in the format <General Quality> [– <Quality Substatus>]
-1: Full representation in the format <General Quality> [Override] [Control Inhibit] – <Quality Substatus>
0: <General Quality>
1: <Quality Substatus>
2: <Quality Limit>
3: <Extended Quality Substatus>
4: <Quality Override>
5: <Control Inhibit>
localized:
The flag indicating if the returned text should be in native language or in Runtime localized language.
Return Value
A textual representation of the quality, or an empty string if the part given is not applicable.
Related Functions
QualityGetPart, QualityIsBad, QualityIsContolInhibit, QualityIsGood, QualityIsOverride, QualityIsUncertain, QualitySetPart, QualityCreate
Example
QUALITY q;; STRING str; q = QualityCreate(QUAL_GOOD, 0, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_NON_SPECIFIC, 1, 1, 0); str = QualityToStr(q, -1, 0); // The result is: Good [Override] [Control Inhibit] q = QualityCreate(QUAL_GOOD, QUAL_GOOD_LOCAL_OVERRIDE, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_NON_SPECIFIC); str = QualityToStr(q, 1, 0); // The result is: Overriden q = QualityCreate(QUAL_GOOD, 0, QUAL_LIMITED_QL_LOW_LIMITED, QUAL_EXT_NON_SPECIFIC); str = QualityToStr(q, 2, 0); // The result is: Below Low SetLanguage("FRENCH"); q = QualityCreate(QUAL_GOOD, 0, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_NON_SPECIFIC, 1, 1, 0); str = QualityToStr(q, -1, 1); // The result is: Bon [Supplémenté] [Contrôle Inhibé] // Entries for ‘Bon’, ‘Supplémenté’ and ‘Contrôle Inhibé’ // needs to have been provided in FRENCH.dbf SetLanguage("ENGLISH"); q = QualityCreate(QUAL_BAD, QUAL_BAD_CONFIGURATION_ERROR, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_NON_SPECIFIC); str = QualityToStr(q, -1, 0); // The result is: Bad - Configuration Error SetLanguage("FRENCH"); q = QualityCreate(QUAL_BAD, QUAL_BAD_CONFIGURATION_ERROR, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_NON_SPECIFIC); str = QualityToStr(q, -1, 1); // The result is: Mauvais - Erreur de Configuration SetLanguage("ENGLISH"); q = QualityCreate(QUAL_UNCR, QUAL_UNCR_NON_SPECIFIC, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_TAG_OUT_OF_RANGE); str = QualityToStr(q, 0, 0); // The result is: Uncertain q = QualityCreate(QUAL_UNCR, QUAL_UNCR_NON_SPECIFIC, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_TAG_OUT_OF_RANGE); str = QualityToStr(q, 3, 0); // The result is: Tag Address Out Of Range q = QualityCreate(QUAL_UNCR, QUAL_UNCR_SUBNORMAL, QUAL_LIMITED_NOT_LIMITED, QUAL_EXT_NON_SPECIFIC); str = QualityToStr(q, 1, 0); // The result is: Subnormal
See Also
Published June 2018