ATRTOU

Description

This function reads the UNITS block from the road property file and returns a character array which contains the unit strings.

C Calling Sequence

int c_atrtou(int *id, char *units);

Arguments

Argument Type Description
id Integer Input This is an Identifier which is associated with the TeimOrbit file.
Units
  • UNITS(0): force
  • UNITS(1): mass
  • UNITS(2): length
  • UNITS(3): time
  • UNITS(4): angle
Character Array Output This Units (block) is a array of five strings which is read from the TeimOrbit file.

FORTRAN Calling Sequence:

DLLFUNC void STDCALL ATRTOU(int *id, char *units, int dummylen)

Arguments

Argument Type Description
id Integer Input This is an Identifier which is associated with the TeimOrbit file.
Units
  • UNITS(0): force
  • UNITS(1): mass
  • UNITS(2): length
  • UNITS(3): time
  • UNITS(4): angle
Character Array Output This Units (block) is a array of five strings which is read from the TeimOrbit file.
Note: Before using the ATRTOU function, you must use the int c_rto_open_file(const char *fName) function to open the road property file for reading the UNITS block. If the units block is not found in the property file or if the unit string is not found inside the units block then ATRTOU function returns with an error.