NAME

change_segment_references − change segment-referencing elements to reference a different segment

SYNOPSIS

C Syntax:

void change_segment_references ( fildes, old_segno, new_segno )
int fildes, old_segno, new_segno;

FORTRAN77 Syntax:

subroutine change_segment_references ( fildes,
old_segno, new_segno )
integer*4 fildes, old_segno, new_segno

Pascal Syntax:

procedure change_segment_references ( fildes,
old_segno, new_segno:integer );

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened. 

old_segno Old segment name. 

new_segno New segment name. 

Discussion

Change_segment_references operates on all segments in the display list of the specified graphics device.  It replaces all call_segment, execute_segment, cond_call_segment, and cond_execute_segment elements that call old_segno with corresponding elements that call new_segno.  If there are calls to old_segno and the new segment does not exist, new_segno is created.  If there are no calls to old_segno, no changes are made and no error is generated. 

ERRORS

1 Graphics device is not initialized for this operation. 

SEE ALSO

rename_segment(3G), rename_segment_and_references(3G). 

Hewlett-Packard Company  —  HP-UX Release 10.0