readf statement

The readf statement reads the specified number of characters from a normal item.


readf str from file.var, item.ID,
start.pos, no.of.bytes then/else statement.block


D3 allows the user to read a specified number of characters from any normal item stored in a disk file. The format is very similar to readv, but rather than specifying the attribute to be read, the user specifies the starting position and number of bytes to read. readfu behaves like readvu and sets and obeys item locks.

If a starting position of 0 is specified, the number of bytes in the item is returned. If a starting position beyond the end of the item is specified, null is returned. If too many bytes are specified, as many as are available are returned.