BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kfile_getstate - return the current internal stream transport state
LIBRARY CALL
unsigned long int kfile_getstate(
kfile *file)
INPUT
- file - the kfile transport to be returned
OUTPUT
none
RETURN VALUE
The type associated with the kfile transport on success,
or NULL upon failure
DESCRIPTION
This routine returns the internal state of a khoros stream
transport. The state is mask of the following defines:
KFILE_READ - whether transport is readable
KFILE_WRITE - whether transport is writeable
KFILE_RDWR - whether transport is readable &
writeable
KFILE_MYBUF - whether transport uses user defined
stream buffer
KFILE_EOF - whether transport is at end of file
KFILE_ERR - whether transport is in an error
KFILE_PERM - whether transport has data permanence
KFILE_OPEN - whether transport is currently opened
KFILE_DUP - whether transport is currently dupped
KFILE_TEMP - whether transport is a temporary
KFILE_STREAM - whether transport is a temporary
KFILE_LOCK - whether transport enforces locking
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
the type field returned is the internal copy of the
kfile transport. This means that you should not
modify or free the string.
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/kfile.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.