sm_fio_editor

Programming Guide

Invokes an external text editor for an array
int sm_fio_editor(char *array_name);
array_name
The name of the array whose contents you wish to edit.

Returns

0 Success.

-4 SMFIO_IO_ERROR: Standard I/O error. Check the value in system variable errno to determine the nature of the error.

-8 SMFIO_FIELD_ERROR: Nonexistent field.

-9 SMFIO_FILE_TRUNCATE: Array not large enough to accept all file data; partial read was successful.

-10 SMFIO_LINE_BREAK: One or more lines in the file were too long and wrapped to the next occurrence.

-11 SMFIO_NO_EDITOR: Panther behavior variable SMEDITOR is undefined; no editor is available to handle the operation.

-12 SMFIO_PUTFIELD: Unable to write to the field.

-13 SMFIO_GETFIELD: Unable to read the field's contents.

Description

sm_fio_editor invokes the editor specified in the behavior variable SMEDITOR and writes the contents of array_name to a temporary file. Each occurrence is written as a single line to that file.
When you exit the editor, Panther writes the edited text back to the array. Panther attempts to write each line in the file to a single occurrence. If any line is too long for its target occurrence, Panther breaks the line and writes the overflow text to the next occurrence. If the array contains too few occurrences to read the entire file, sm_fio_editor discards the excess text.