DBgetCoordinates

An input read and into a co-ordinate convert.

This routine gets a text of the input line and delivers the co-ordinates of a point and the connecting information as an issue. Besides, the co-ordinates are rounded on the grid invested with Grid if such is defined. If a conversion mistake appears, it does not concern with the text a co-ordinate, then the function 0 delivers, but the connecting information is delivered as a result. The input has to go in the form

#<left> <x> <y>

are given and left one of the sign chains "P", "L", "C", "R", "CON", "RPT", "CLS" and "IBID." is. x and y are floating decimal point figures.

Parametre

root (PROOT) [IN]

The trading of the data bank.

x (stands in *) [(IN) / OUT]

y (stands in *) [(IN) / OUT]

Here the position is filed.

cp (PCOORDINATE_PARAMETER)

The structure COORDINATE_PARAMETER contains, in addition, still the co-ordinate for the z axis. If a valid z co-ordinate exists, stands in the Flag valid the constant COORDINATE_PARAMETER_VALID_Z. The structure is described in the Include file basic.h.

Result

(int) [OUT]

Here the connecting information is delivered.

LINK_P with #P

LINK_L with #L

LINK_R with #R

LINK_C with #C

LINK_CON with #CON or #N

LINK_CLS with #CLS or #S

LINK_EBD with #EBD or #E

LINK_RPT with #RPT or #T

0 with conversion mistake.

Declaration

#include "database.h"

int DLLENTRY DBgetCoordinates (

PROOT root,

stand in * x,

stand in * y,

PCOORDINATE_PARAMETER cp

);