Provided by: alliance_5.0-20120515-6_amd64 bug

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();
       }

SEE ALSO

       genlib(1), GENLIB_DEF_PHFIG(3),  GENLIB_SAVE_PHFIG(3),  GENLIB_PHREF(3),  GENLIB_PHSEG(3),
       GENLIB_COPY_UP_REF(3),           GENLIB_COPY_UP_ALL_REF(3),           GENLIB_GET_REF_X(3),
       GENLIB_GET_REF_X(3), GENLIB_GET_REF_X(3).