| NORSYS SOFTWARE © 2007 | NETICA API | C VERSION 3.25

stream_ns* NewFileStream_ns ( | const char* filename, environ_ns* env, const char* access )

Returns a Norsys stream for the file with name filename.

This stream can then be passed as an argument to functions which read or write a file, to identify which file to read or write.

Pass NULL for access; it is only for future expansion.

When finished with the stream_ns created, delete it with DeleteStream_ns.

filename may contain a path to indicate in which directory the file is located. It should be a string in the format normally understood by the operating system currently being used (see the examples below).

filename does not have to indicate a file which already exists.

Netica won't modify or free the passed filename string.

Version:

In versions previous to 2.10, this function was named FileNamed_ns, and between versions 2.10 and 2.26 it was called NewStreamFile_ns.

See also:

DeleteStream_ns |  | Delete it when done
WriteNet_bn |  | Saves a net to a file with name specified by the passed stream
WriteNetFindings_bn |  |
ReadNetFindings_bn |  |
ReadNet_bn |  | Reads a net from the file identified by the passed stream

Example:

    See WriteNet_bn
    //
    // Examples for UNIX / Linux
    //
    file = NewFileStream_ns ("temp3", env, NULL);
    file = NewFileStream_ns ("/local/project1/configure.bn.txt", env, NULL);
    file = NewFileStream_ns ("../nets/Umbrella.dne", env, NULL);
    //
    // Examples for MS Windows
    //
    file = NewFileStream_ns ("temp3", env, NULL);
    file = NewFileStream_ns ("C:local\project1\configur.txt", env, NULL);
    file = NewFileStream_ns ("..\nets\Umbrella.dne", env, NULL);
    //
    // Examples for MacOS
    //
    file = NewFileStream_ns ("temp3", env, NULL);
    file = NewFileStream_ns ("local:project1:configure.bn.txt", env, NULL);
    file = NewFileStream_ns ("::nets:Umbrella.dne", env, NULL);