cf.of_fraction

cf.of_fraction(*arg)

The amount of concurrently open files above which files containing data arrays may be automatically closed.

Deprecated at version 3.14.0 and is no longer available.

The amount is expressed as a fraction of the maximum possible number of concurrently open files.

Note that closed files will be automatically reopened if subsequently needed by a variable to access its data array.

See also

cf.close_files, cf.close_one_file, cf.open_files, cf.open_files_threshold_exceeded

Parameters

arg: float or Constant, optional

The new fraction (between 0.0 and 1.0). The default is to not change the current behaviour.

Returns

Constant

The value prior to the change, or the current value if no new value was specified.

Examples

>>> cf.of_fraction()
0.5
>>> old = cf.of_fraction(0.33)
>>> cf.of_fraction(old)
0.33
>>> cf.of_fraction()
0.5

The fraction may be translated to an actual number of files as follows:

>>> old = cf.of_fraction(0.75)
>>> import resource
>>> max_open_files = resource.getrlimit(resource.RLIMIT_NOFILE)[0]
>>> threshold = int(max_open_files * cf.of_fraction())
>>> max_open_files, threshold
(1024, 768)