acdbSNValid

C++

ACCORE_PORT int acdbSNValid(
    const ACHAR * tbstr, 
    int pipetest
);

File

acedads.h

Description

Tests a symbol table name for validity, including symbol table names with out-of-code-page escape sequences.

For applications that read a symbol table name from the keyboard, set pipetest to FALSE , because other functions would not accept a name containing the | character.

A symbol table name is valid if it is non-null and contains only characters allowed in filenames except the comma, semicolon, accent grave, and equals sign, which are also not allowed.

Note

This function works only with symbol table names in the current document. It does not work with non-current documents or in zero-document state.

Parameters

Parameters	Description
tbstr	Null-terminated symbol table name, (for example, "LAYER0")
pipetest	If TRUE the pipe character (\|) is allowed in the table name; if FALSE , the pipe character is not allowed

Returns

Returns RTNORM if the symbol table name is valid in the current document. Otherwise, it returns OL_ESNVALID.

Previous Declaration

AutoCAD 2025 and Earlier

int acdbSNValid(const ACHAR *tbstr, int pipetest);