tsc_Format

Contains a set of static methods for converting internal values into formatted strings, taking into account the current settings for format and units.  For instance, the VertDistance method will output a vertical distance - which is represented internally in metres - as a string converted to US Survey feet, International Feet, or Metres (or Meters), depending on the current vertical distance display configuration.

Where appropriate, the returned string will also contain the units (eg, 3.216ift).  All values are left-aligned and contain no leading or trailing spaces.

Important: These methods are designed for displaying data to the user.  Except for Integer() and Scalar() which are unitless, avoid using them to output text into files or other persistent data.  External data should be independent of the current configuration and therefore be written in the internal SI units.

Static methods

static tsc_String   Integer       (int    value);
static tsc_String   Scalar        (double value, int precision = 3); // precision = number of decimal places.
static tsc_String   Azimuth       (double azimuth);
static tsc_String   Angle         (double angle);
static tsc_String   DeltaAngle    (double deltaAngle);
static tsc_String   Latitude      (double angle);
static tsc_String   Longitude     (double angle);
static tsc_String   Grade         (double gradeAngle);
static tsc_String   VertDistance  (double distance);
static tsc_String   HorzDistance  (double distance);
static tsc_String   SlopeDistance (double distance);
static tsc_String   VertCoordinate(double coordinate);
static tsc_String   HorzCoordinate(double coordinate);
static tsc_String   Stationing    (double distance, int stationZone, int precision = -1);
static tsc_String   Timestamp     (double localTime);
static tsc_String   Time          (double localTime);
static tsc_String   Date          (double localTime);
static tsc_String   PrismConstant (double prismConst);