Download the documentation - True BASIC

16 Statistics Graphics Toolkit
TextToNum2 (n$(,), n(,))
TextToNum converts a string array n$(,) to the corresponding numeric array n(,) by
using StatVal on each element. The two arrays needn’t have the same bounds; the target
array’s lower bounds are left untouched and its upper bounds adjusted.
NumToText2 (n(,), n$(,))
NumToText converts a numeric array n(,) to the corresponding string array n$(,) by
using StatStr$ on each element. The two arrays needn’t have the same bounds; the target
array’s lower bounds are left untouched and its upper bounds adjusted.
GetStatFile (#n, n$(,))
GetStatFile reads a text file full of statistics data into an array. The file #n must be
opened before you call GetStatFile by a statement such as OPEN #1: NAME “datafile”.
Each row and column of the text file data goes into the appropriate item of n$(,).
Each line of the text file is treated as a row. Blank lines are ignored. Columns are separated
by either a tab character, or two or more spaces. Lines in the file may have different
numbers of columns; short rows are “left justified” in the n$(,) array. Thus if the
first line in a file contains three columns but some line within the file contains only one
data item, the last two n$(,) entries for that line are the null string. For example:
File
n$(,)
Name Age Weight “Name” “Age” “Weight”
Allen 34 185 “Allen “34” “185”
Byron 170 “Byron” “170” ““
Darcy “Darcy” ““ ““
These rules let you read SPSS files, Excel files, Lotus 1-2-3 files, and text files created
by most common application programs.
Note that all data items are taken as strings; thus you can use files that include column
headers, extraneous information, etc. To convert n$(,) to a numeric array, changing
all nondata items to missing values, try:
call SetHaveMissing(1)
call SetMissingText(““)
call TextToNum2(n$(,), n(,))
See the program GETFILE on your disk for an example.
01/01