HP C/iX Library Reference Manual (30026-90004)

ManualsBrandsHP ManualsSoftwareMPE/iX 7.0 Operating System

121

122

123

124

125

126

127

128

129

130

176 Chapter5

HP C/iX Library Function Descriptions

freopen

The R option speciﬁes the size of the record if the ﬁle is created by this

open request. If the V option is also used, this option speciﬁes the

maximum size of the variable sized records. The option letter is followed

by a decimal number that is equal to the number of bytes in the record

size. Notice that the number must be positive. A byte count is always

speciﬁed. The default for text and binary streams is 256 bytes. The default

for byte streams is 1 byte.

The S option speciﬁes the maximum size of the ﬁle. The value of

is the

maximum size of the ﬁle in records for text and binary streams, and in

bytes for byte streams. The default for text and binary streams is 4095

records. The default for byte streams is 2 gigabytes.

Te If the Te option is speciﬁed, the ﬁle is saved in the temporary ﬁle domain.

If the Te option is not speciﬁed and the ﬁle is a new ﬁle, the default is to

save the ﬁle as a permanent ﬁle. If the ﬁle is old, the default is to not

change the disposition.

Tm If the Tm option is speciﬁed, disk read functions trim editor line numbers, if

they exist, and trailing blanks from each record of an ASCII ﬁxed record

length ﬁle before returning ﬁle data to the reader. This option is used on

ﬁles opened with read only access. Random access to ﬁle data using

fseek() and lseek(), is not permitted. The default is not to trim editor

line numbers and blanks.

If the U option is speciﬁed, the ﬁle is created with

user-label records. If

this option is not speciﬁed, the default is no user-label records.

V If the V option is speciﬁed, the ﬁle is created with an MPE variable-length

record format. This option is mutually exclusive with the Bs option. If the

V or Bs options are not speciﬁed, then the ﬁle is created with an MPE

ﬁxed-length record format.

The X option controls exclusive access ability for the ﬁle. The option

character is followed by an integer that indicates the level of exclusivity

for this open request. The levels are speciﬁed in the MPE/iX Intrinsics

Reference Manual under the FOPEN intrinsic description.

The following example creates or opens a stream associated with a ﬁxed record ASCII ﬁle

for writing with 80-byte records and a ﬁle size of 1000 records:

#include <stdio.h>

FILE *

stream

;

stream

freopen

filename

","w R80 S1000",stdout);