Function Entry: ANGTOS

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

Function Entry: ANGTOS

Name

angtos

Class

Conversion Function

Syntax

(angtos angle [unit [precision]])

Arguments and Values

  • angle — integer or real, interpreted in radians
  • unit — optional integer angular-unit selector
  • precision — optional integer precision

Description

Converts a numeric angle value to a formatted string.

Return Values

A string if successful; otherwise nil.

Affected By

  • angle formatting conventions
  • unit and precision parameters

Notes

  • Autodesk documents the accepted unit values as those of AUNITS:
    • 0 degrees
    • 1 degrees/minutes/seconds
    • 2 grads
    • 3 radians
    • 4 surveyor's units
  • If unit is omitted, Autodesk documents that angtos uses the current AUNITS value.
  • If precision is omitted, Autodesk documents that angtos uses the current AUPREC value.
  • Autodesk documents that the result is additionally affected by UNITMODE and DIMZIN.
  • Autodesk documents that negative angles are reduced to an equivalent positive angle between 0 and 2*pi before formatting.
  • Measured (probes/sources/probe-rtos.lsp, AutoCAD 2022 and BricsCAD V26, 2026-10-03): in surveyor's units, an angle a hair past north (1.5707963268) at precision 0 is "N 0d W" on AutoCAD (the unrounded side) but "N 0d E" on BricsCAD (a deviation that rounds to zero is called east). A French AutoCAD prints O (Ouest) for west.

Availability

  • AutoCAD 2026: documented (per Autodesk reference page).
  • BricsCAD V26: presumed compatible (no contradicting page found).
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.