genlib_get_ref_x.3 (3)

NAME
SYNOPSYS
PARAMETERS
RETURN VALUE
ERRORS
EXAMPLE
SEE ALSO

NAME

GENLIB_GET_REF_X - retrieve the x coordinate of an instance reference

SYNOPSYS

long GENLIB_GET_REF_X(insname, refname)
char *insname, *refname;

PARAMETERS

insname: Name of the instance in the which the reference is to be searched for
refname: Name of the reference SH DESCRIPTION GET_REF_X looks for the reference, refname, in the instance called insname.

RETURN VALUE

The function returns a long int beeing the x position of the reference in the current figure

ERRORS

"GENLIB_GET_REF_X impossible : missing GENLIB_DEF_PHFIG"

: No figure has been yet specified by a call to DEF_PHFIG. So it isn't possible to place a reference inside it. you must call DEF_PHFIG before any other layout action.

"GENLIB_GET_REF_X impossible : missing GENLIB_DEF_PHFIG"

: No figure has been yet specified by a call to DEF_PHFIG. So it isn't possible to place a reference inside it. you must call DEF_PHFIG before any other layout action.

"GENLIB_GET_REF_X impossible : no abutment box"

: The current figure does not have an abutment box. Use DEF_AB(3) before this function.

"illegal GENLIB_GET_REF_X : orientation is XX"

: The face parameter does not have a legal value, but XX.

"illegal getphins : instance called insname does not exist"

: No instance called insname exists in the current figure

"illegal getphref : references called refname does not exist"

: No reference called refname exists in the model of the instance insname.

EXAMPLE

#include <genlib.h>
main()
{
        /* Create a figure to work on  */
        GENLIB_DEF_PHFIG("cell");
        GENLIB_PLACE("gaci0_b", "r1", NOSYM, 23L, 54L);
        /* Put a reference */
        GENLIB_GET_REF_X("r1", "a_0", ALU2, 2, NORTH);
        /* Save that on disk */
        GENLIB_SAVE_PHFIG();
}