AcDbSymbolUtilities::Services::preValidateSymbolName

C++

Acad::ErrorStatus preValidateSymbolName(
    ACHAR *& pSymbolName, 
    bool preserveCase
) const;

Description

Deprecated. Perform any "pre-validation" steps on a string that will be validated as a symbol name:

Normalize the name. If preserveCase is false, the symbol name is converted to uppercase.
Strip leading and trailing whitespace.

Note: Correspondence between preserveCase and the meaning for EXTNAMES=1. When EXTNAMES=1, AutoCAD preserves the case of symbol names. When EXTNAMES=0, AutoCAD forces names to uppercase, which is the corresponding behavior of passing in false for preserveCase.

Parameters

Parameters	Description
pSymbolName	Updated pointer to symbol name
preserveCase	Input Boolean to indicate whether to preserve the case of alphabetic letters

Returns

Returns Acad::eOk if successful.

Links

AcDbSymbolUtilities::Services, AcDbSymbolUtilities Namespace

Use Instead

virtual Acad::ErrorStatus preValidateSymbolName(AcString & sSymbolName, bool preserveCase) const = 0;