BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kfile_getstate - return the current internal stream transport state

LIBRARY CALL

unsigned long int kfile_getstate(
   kfile *file)

INPUT

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.