Concept Framework 1.0 documentation Contents | Index

standard.C.io.fgetstring

Name Version Deprecated
fgetstring version 1.0 no

Prototype:
string fgetstring(number fd, string separator, number max_size)

Parameters:
fd      [in] A valid file descriptor
separator      [in] String separator
max_size      [in] Maximum number of bytes to be read

Description:
fgetstring reads one item from the input file, fd, formed by the string separator, with maximum size max_size.
If separator contains a value that is not found, then fgetstring will return the content of the input file.

Example:
import standard.C.io


define FILENAME "test.txt"

class Main {
function Main() {
if(!(var fd = fopen( FILENAME, "r" )))
echo "The file " + FILENAME + " was not opened\n";
else {
var buffer = "*";
while (!feof(fd))
echo fgetstring(fd, buffer, 10)+"\n";
fclose(fd);
}
}
}

Input test.txt
First item*Second item*Third item

Results
First item
Second item
Third item

Returns:
Returns the string read.

Documented by Simona Plesuvu, generation time: Thu Oct 15 20:02:04 2009 GMT(c)2009 RadGs Software