spec - Local Sector 7 web page

tty_fmt(x, y, wid, string) — Writes the string string to the screen starting at columnx and row y ,where column 0, row 0 is the upper left corner of the screen.The string is only written to the "tty" device and only if it is turned on foroutput. If string is longer than the width given by wid ,the string is split atspace characters such that no line is longer then wid . Newlines in the stringare retained, however. The function will truncate words that are wider thanwid and drop lines that would go off the bottom of the screen. Special tty controlsequences of the form \[xx] ,where xx is one of the codes listed for thetty_cntl() function above, can be used with string . Negative x or y positionthe cursor relative to the left or bottom edges of the screen, respectively. Thefunction returns the number of lines written.Binar y Input/OutputThe facility for binary file input and output allows users and sites to create arbitrarybinary file formats for writing and reading spec data arrays. Csource code for anumber of formats is included in the spec distribution.fmt_read(file, fmt, arr [, header [, flags ]]) —fmt_write(file, fmt, arr [, header [, flags ]]) —fmt_close(file, fmt) —In these functions file is the name of the data file, fmt selects which format to useand arr is the data array. The optional header argument is an associative array thatmay containing identifying information to be saved with the binary values in thedata array. The optional flags argument is reserved for future enhancements.88 REFERENCE MANUAL INTERIM WORK-IN-PROGRESS (8/16/01) NOT FOR GENERAL DISTRIBUTION