AcDbSymbolUtilities::Services::repairSymbolName

C++

Acad::ErrorStatus repairSymbolName(
    ACHAR *& pNewName, 
    const ACHAR * oldName, 
    bool allowVerticalBar
) const;

Description

Deprecated. Returns a "repaired" copy of the specified string. The method uses the same symbol name validation rules as the validation functions (such as validatePreExtendedSymbolname() and validateSymbolName()) except that the returned copy of the string does not contain any illegal characters. Those are replaced with valid replacement characters.

repairSymbolName() will return Acad::eOk or Acad::eInvalidInput if the specified name is NULL or empty.

If the symbol name was repaired, then pNewName is a copy of the repaired symbol name allocated via acutUpdString(), which will delete any previously allocated memory. The caller is responsible for freeing the string via acutDelString() when it is no longer needed. The pointer pNewName is NULL if oldName did not need any repairing.

Parameters

Links

AcDbSymbolUtilities::Services, AcDbSymbolUtilities Namespace

Use Instead

virtual Acad::ErrorStatus repairSymbolName(AcString & sNewName, const ACHAR * oldName, bool allowVerticalBar) const = 0;