[][src]Trait opencv::prelude::FileStorageTrait

pub trait FileStorageTrait {
    pub fn as_raw_FileStorage(&self) -> *const c_void;
pub fn as_raw_mut_FileStorage(&mut self) -> *mut c_void; pub fn state(&self) -> i32 { ... }
pub fn set_state(&mut self, val: i32) { ... }
pub fn elname(&self) -> String { ... }
pub fn set_elname(&mut self, val: &str) { ... }
pub fn open(
        &mut self,
        filename: &str,
        flags: i32,
        encoding: &str
    ) -> Result<bool> { ... }
pub fn is_opened(&self) -> Result<bool> { ... }
pub fn release(&mut self) -> Result<()> { ... }
pub fn release_and_get_string(&mut self) -> Result<String> { ... }
pub fn get_first_top_level_node(&self) -> Result<FileNode> { ... }
pub fn root(&self, streamidx: i32) -> Result<FileNode> { ... }
pub fn get(&self, nodename: &str) -> Result<FileNode> { ... }
pub fn get_node(&self, nodename: &str) -> Result<FileNode> { ... }
pub fn write_i32(&mut self, name: &str, val: i32) -> Result<()> { ... }
pub fn write_f64(&mut self, name: &str, val: f64) -> Result<()> { ... }
pub fn write_str(&mut self, name: &str, val: &str) -> Result<()> { ... }
pub fn write_mat(&mut self, name: &str, val: &Mat) -> Result<()> { ... }
pub fn write_str_vec(
        &mut self,
        name: &str,
        val: &Vector<String>
    ) -> Result<()> { ... }
pub fn write_raw(
        &mut self,
        fmt: &str,
        vec: *const c_void,
        len: size_t
    ) -> Result<()> { ... }
pub fn write_comment(&mut self, comment: &str, append: bool) -> Result<()> { ... }
pub fn start_write_struct(
        &mut self,
        name: &str,
        flags: i32,
        type_name: &str
    ) -> Result<()> { ... }
pub fn end_write_struct(&mut self) -> Result<()> { ... }
pub fn get_format(&self) -> Result<i32> { ... } }

XML/YAML/JSON file storage class that encapsulates all the information necessary for writing or reading data to/from a file.

Required methods

Loading content...

Provided methods

pub fn state(&self) -> i32[src]

pub fn set_state(&mut self, val: i32)[src]

pub fn elname(&self) -> String[src]

pub fn set_elname(&mut self, val: &str)[src]

pub fn open(
    &mut self,
    filename: &str,
    flags: i32,
    encoding: &str
) -> Result<bool>
[src]

Opens a file.

See description of parameters in FileStorage::FileStorage. The method calls FileStorage::release before opening the file.

Parameters

  • filename: Name of the file to open or the text string to read the data from. Extension of the file (.xml, .yml/.yaml or .json) determines its format (XML, YAML or JSON respectively). Also you can append .gz to work with compressed files, for example myHugeMatrix.xml.gz. If both FileStorage::WRITE and FileStorage::MEMORY flags are specified, source is used just to specify the output file format (e.g. mydata.xml, .yml etc.). A file name can also contain parameters. You can use this format, "*?base64" (e.g. "file.json?base64" (case sensitive)), as an alternative to FileStorage::BASE64 flag.
  • flags: Mode of operation. One of FileStorage::Mode
  • encoding: Encoding of the file. Note that UTF-16 XML encoding is not supported currently and you should use 8-bit encoding instead of it.

C++ default parameters

  • encoding: String()

pub fn is_opened(&self) -> Result<bool>[src]

Checks whether the file is opened.

Returns

true if the object is associated with the current file and false otherwise. It is a good practice to call this method after you tried to open a file.

pub fn release(&mut self) -> Result<()>[src]

Closes the file and releases all the memory buffers.

Call this method after all I/O operations with the storage are finished.

pub fn release_and_get_string(&mut self) -> Result<String>[src]

Closes the file and releases all the memory buffers.

Call this method after all I/O operations with the storage are finished. If the storage was opened for writing data and FileStorage::WRITE was specified

pub fn get_first_top_level_node(&self) -> Result<FileNode>[src]

Returns the first element of the top-level mapping.

Returns

The first element of the top-level mapping.

pub fn root(&self, streamidx: i32) -> Result<FileNode>[src]

Returns the top-level mapping

Parameters

  • streamidx: Zero-based index of the stream. In most cases there is only one stream in the file. However, YAML supports multiple streams and so there can be several.

Returns

The top-level mapping.

C++ default parameters

  • streamidx: 0

pub fn get(&self, nodename: &str) -> Result<FileNode>[src]

Returns the specified element of the top-level mapping.

Parameters

  • nodename: Name of the file node.

Returns

Node with the given name.

pub fn get_node(&self, nodename: &str) -> Result<FileNode>[src]

Returns the specified element of the top-level mapping.

Parameters

  • nodename: Name of the file node.

Returns

Node with the given name.

Overloaded parameters

pub fn write_i32(&mut self, name: &str, val: i32) -> Result<()>[src]

Simplified writing API to use with bindings.

Parameters

  • name: Name of the written object. When writing to sequences (a.k.a. "arrays"), pass an empty string.
  • val: Value of the written object.

pub fn write_f64(&mut self, name: &str, val: f64) -> Result<()>[src]

Simplified writing API to use with bindings.

Parameters

  • name: Name of the written object. When writing to sequences (a.k.a. "arrays"), pass an empty string.
  • val: Value of the written object.

Overloaded parameters

pub fn write_str(&mut self, name: &str, val: &str) -> Result<()>[src]

Simplified writing API to use with bindings.

Parameters

  • name: Name of the written object. When writing to sequences (a.k.a. "arrays"), pass an empty string.
  • val: Value of the written object.

Overloaded parameters

pub fn write_mat(&mut self, name: &str, val: &Mat) -> Result<()>[src]

Simplified writing API to use with bindings.

Parameters

  • name: Name of the written object. When writing to sequences (a.k.a. "arrays"), pass an empty string.
  • val: Value of the written object.

Overloaded parameters

pub fn write_str_vec(&mut self, name: &str, val: &Vector<String>) -> Result<()>[src]

Simplified writing API to use with bindings.

Parameters

  • name: Name of the written object. When writing to sequences (a.k.a. "arrays"), pass an empty string.
  • val: Value of the written object.

Overloaded parameters

pub fn write_raw(
    &mut self,
    fmt: &str,
    vec: *const c_void,
    len: size_t
) -> Result<()>
[src]

Writes multiple numbers.

Writes one or more numbers of the specified format to the currently written structure. Usually it is more convenient to use operator << instead of this method.

Parameters

  • fmt: Specification of each array element, see @ref format_spec "format specification"
  • vec: Pointer to the written array.
  • len: Number of the uchar elements to write.

pub fn write_comment(&mut self, comment: &str, append: bool) -> Result<()>[src]

Writes a comment.

The function writes a comment into file storage. The comments are skipped when the storage is read.

Parameters

  • comment: The written comment, single-line or multi-line
  • append: If true, the function tries to put the comment at the end of current line. Else if the comment is multi-line, or if it does not fit at the end of the current line, the comment starts a new line.

C++ default parameters

  • append: false

pub fn start_write_struct(
    &mut self,
    name: &str,
    flags: i32,
    type_name: &str
) -> Result<()>
[src]

Starts to write a nested structure (sequence or a mapping).

Parameters

  • name: name of the structure. When writing to sequences (a.k.a. "arrays"), pass an empty string.
  • flags: type of the structure (FileNode::MAP or FileNode::SEQ (both with optional FileNode::FLOW)).
  • typeName: optional name of the type you store. The effect of setting this depends on the storage format. I.e. if the format has a specification for storing type information, this parameter is used.

C++ default parameters

  • type_name: String()

pub fn end_write_struct(&mut self) -> Result<()>[src]

Finishes writing nested structure (should pair startWriteStruct())

pub fn get_format(&self) -> Result<i32>[src]

Returns the current format.

Returns

The current format, see FileStorage::Mode

Loading content...

Implementors

impl FileStorageTrait for FileStorage[src]

impl FileStorageTrait for PtrOfFileStorage[src]

Loading content...