Function Entry: LAYERSTATE-COMPARE

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: LAYERSTATE-COMPARE

Name

layerstate-compare

Class

Layer-State Function

Syntax

(layerstate-compare layerstatename)

Arguments and Values

  • layerstatename: string; the layer state to compare against the current drawing's layer settings.

Description

Compares a saved layer state with the current state of layers in the drawing and reports which layers have differences. Useful for previewing the effect of layerstate-restore before applying it.

Return Values

A list of layer names that differ from the saved state, or nil when there are no differences.

Side Effects

None.

Examples

Not documented on the vendor page.

Availability

  • AutoCAD 2026: documented (Windows, macOS).
  • BricsCAD V26: not under this name (parallel BricsCAD family vl-layerstates-* does not currently document a comparator). See Phase 4 cross-reference.
  • Status: AutoCAD-named family with BricsCAD divergence — see Phase 4 reconciliation.

See Also

  • No direct BricsCAD analogue. BricsCAD's parallel vl-layerstates-* family does not currently document this operation; consider implementing in user code or treating as AutoCAD-only.
  • Family pair documented in vendor-inventory-2026.org §10 item 6.

Source Notes