goview Command

Displays or creates the specified view of a named file in an Editor window.

Scope: Global

Syntax

Parameters

newring 
The file view, if created, is opened in a new ring in an Editor window.
split
If specified, the file view is split in an Editor window to accommodate the new ring. Otherwise, the new ring is opened in a new Editor window.
nonewring 
The file view, if created, becomes a member of the current ring.
name 
Searches all open file views for a named view. If it is not found, it will be created.
find 
Searches all open file views for a named view. If it is not found, it will not be created.
ViewName 
The file view name that is returned by the query viewname command.
viewnum ViewNumber 
Searches all open file views for a file view with the specified number. If the view is not found, it is not created.
inring 
Shows the previous file view in the current ring. If the current view is the first view in the ring, the previous file view will be the last view in the current ring.
next inring 
Shows the next file view in the current ring. If the current view is the last file view in the ring, the next file view shown will be the first view in the current ring.
next 
Shows the next file view. If the current view is the last view in a given ring, the next file view shown will be the first view in the next ring.

Description

The goview command with no parameters switches to the next file view. The parameters allow specific file views to be called.

When you specify a parameter and a file view name, the Editor ignores case when making comparisons, though a new name is created exactly as typed.

If you create a new file view without specifying one of the nonewring or newring parameters, the new file view is placed in a new or existing ring according to the value of the ring parameter.

Examples

  1. To search for a file view called myview, type:
    goview name myview 

    If the file view myview is not found, it is created.

  2. To switch to a file view with a number of 45, type:
    goview viewnum 45 
  3. To switch to a file view called functions, type:
    goview find functions 

    If the file view functions is not found, it is not created.

  4. To create a file view in a new ring that will split an Editor window, type:
    goview newring split name mysplitview 

API Return Codes

-1 
A parameter issued with the command was not valid. Check the command 's syntax requirements and then issue the command again using a valid parameter.
-2 
ViewNumber must be in the valid range.
-4 
Exceeds maximum number of views in a ring.
-8 
Insufficient storage to continue.

quitview Command
ring Parameter
viewlist Parameter
viewname Parameter
viewnum Parameter