Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

edftell(3) Guardian Native C Library Calls Reference Manual
NAME
edftell - Retrieves the file-position indicator of an Edit file opened for ANSI I/O
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <stdio.h>
long edftell (
FILE *stream);
PARAMETERS
stream denotes an Edit file opened for ANSI I/O.
DESCRIPTION
The edftell() function retrieves the file-position indicator of an Edit file opened for ANSI I/O.
The edftell() function can be called from Guardian modules (modules compiled for the Guardian
environment) within Guardian and OSS processes. It cannot be called from OSS modules.
The Edit file must be opened with the fopen( ) or freopen( ) Guardian functions variants. Refer
to the fopen(3) or freopen(3) reference pages for details.
RETURN VALUES
The edftell() function returns the file-position indicator of the Edit file, expressed as a long
value. This value is the Edit line number multiplied by 1000. For example, 23000L corresponds
to line 23, and 44120L corresponds to line 44.12.
ERRORS
If the following condition occurs, the edftell( ) function sets errno to the corresponding value:
[EINVAL] The stream is an invalid stream.
For all other error conditions, errno is set to the Guardian error number.
RELATED INFORMATION
Functions: edfseek(3).
STANDARDS CONFORMANCE
The edftell() function is an HP extension to the XPG4 Version 2 specification.
1−72 Hewlett-Packard Company 527192-007