fgetword command

Go to: Synopsis. Return value. Related. MEL examples.

Synopsis

fgetword <int> [ <string> ]

fgetword is undoable, queryable, and editable.

Returns the next word (string of characters separated by white space characters) or nothing at end of file. A second argument may be passed to the fgetword command to specify separators to use instead of the default white space sparators. Characters in the separator string are used to determine word boundaries. The each character in the separator string is treated as an individual separator.

Return value

string

In query mode, return type is based on queried flag.

fclose, feof, fflush, fgetline, fopen, fprint, fread, frewind, fwrite, pclose, popen

MEL examples

// Make a sample file to use as a test example
//
$exampleFileName = ( `internalVar -userTmpDir` + "example.tmp" );
$fileId=`fopen $exampleFileName "w"`;
fprint $fileId "Hello there\nMEL-Developer-+Using+fgetword\n";
fclose $fileId;

// Now read it back one word at a time
//
$fileId=`fopen $exampleFileName "r"`;
string $nextWord = `fgetword $fileId`;
while ( size( $nextWord ) > 0 ) {
    print ( $nextWord + "\n" );
    $nextWord = `fgetword $fileId`;
}
fclose $fileId;

// This will print:
// Hello
// there
// MEL-Developer-+Using+fgetword

// Read it back again using "+" and "-" as separators
//
$fileId=`fopen $exampleFileName "r"`;
string $nextWord = `fgetword $fileId "+-"`;
while ( size( $nextWord ) > 0 ) {
    print ( $nextWord + "\n" );
    $nextWord = `fgetword $fileId "+-"`;
}
fclose $fileId;

// This will print:
// Hello there
// MEL
// Developer
// Using
// fgetword