kfile_comparedata - compare the contents of a transport id to another transport id
LIBRARY CALL
int kfile_comparedata(
int id1,
int id2,
size_t num,
size_t *num_compared)
INPUT
id1 - the first khoros transport descriptor
id2 - the second khoros transport descriptor
num - if not 0 the number of bytes to be compared.
OUTPUT
num_compared - the number of bytes actually compared.
RETURN VALUE
returns an integer less than, equal to, or greater than 0,
according as id1 is lexicographically less than, equal to,
or greater than id2.
DESCRIPTION
This routine compare the contents of a input transport
descriptor to an output transport descriptor. These
descriptors are specified by the Khoros transport
mechanism. An optional "num_compare" can be used to
specify the actual number of bytes to be compared. If
"num_compare" is 0 then all the data from the two transports
are compared.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
data is read from id1 and id2, which means if the transports
do not support data permanence seeking maynot work.
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.