Converts an angular value in radians into a string
Supported Platforms: Windows, Mac OS, and Web
Signature
(angtos angle [unit [precision]])
- angle
-
Type: Integer or Real
A number, in radians.
- unit
-
Type: Integer
An integer that specifies the angular units. If unit is omitted, angtos uses the current value of the AutoCAD AUNITS system variable. The following units may be specified:
0 -- Degrees
1 -- Degrees/minutes/seconds
2 -- Grads
3 -- Radians
4 -- Surveyor's units
- precision
-
Type: Integer
Specifies the number of decimal places of precision to be returned. If omitted, angtos uses the current setting of the AutoCAD AUPREC system variable.
Return Values
Type: String or nil
A string, if successful; otherwise nil.
Remarks
The angtos function takes angle and returns it edited into a string according to the settings of unit and precision, the AutoCAD UNITMODE and DIMZIN system variables.
The angtos function accepts a negative angle argument, but always reduces it to a positive value between zero and 2 pi radians before performing the specified conversion.
The UNITMODE system variable affects the returned string when surveyor's units are selected (a unit value of 4). If UNITMODE = 0, spaces are included in the string (for example, “N 45d E”); if UNITMODE = 1, no spaces are included in the string (for example, “N45dE”).
Examples
(angtos 0.785398 0 4) "45.0000" (angtos -0.785398 0 4) "315.0000" (angtos -0.785398 4) "S 45d E"