Share

AcDbSymbolUtilities::Services::preValidateSymbolName

C++

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

Description

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
sSymbolName Output 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

Was this information helpful?