Reads lines of text from a file into a string array retaining newlines.
// Specify file name with full path fname = getGAUSSHome("examples/housing.csv"); // Open file handle for reading fh = fopen(fname, "r"); // Read the first 3 lines of the file s = fgetsa(fh, 3);
After the above code, s will equal:
"taxes","beds","baths","new","price","size" 3104,4,2,0,279.9,2048 1173,2,1,0,146.5,912
Note that s will be a 3x1 string array. Though the final character in each line is the newline character. So if you print the contents of s in GAUSS, you will see an empty line between each line of text.
fgetsa() procedure reads up to numl lines of text. If
fgetsa() reaches the end of the file before reading numl lines, sa will be shortened. Lines are read in the same manner as
fgets(), except that no limit is placed on the size of a line. Thus,
fgetsa() always returns complete lines of text with newlines retained.
If numl is 1,
fgetsa() returns a string. (This is one way to read a line from a file without placing a limit on the length of the line.)