GNU Octave  6.2.0
A high-level interpreted language, primarily intended for numerical computations, mostly compatible with Matlab
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | Friends | List of all members
octave::base_stream Class Referenceabstract

#include "oct-stream.h"

Inheritance diagram for octave::base_stream:
Inheritance graph
[legend]
Collaboration diagram for octave::base_stream:
Collaboration graph
[legend]

Public Member Functions

 base_stream (const base_stream &)=delete
 
 base_stream (std::ios::openmode arg_md=std::ios::in|std::ios::out, mach_info::float_format ff=mach_info::native_float_format(), const std::string &encoding="utf-8")
 
virtual ~base_stream (void)=default
 
void close (void)
 
virtual void do_close (void)
 
virtual bool eof (void) const =0
 
std::string error (bool clear, int &err_num)
 
virtual int file_number (void) const
 
virtual std::istream * input_stream (void)
 
bool is_open (void) const
 
virtual std::string name (void) const =0
 
bool ok (void) const
 
base_stream & operator= (const base_stream &)=delete
 
virtual std::ostream * output_stream (void)
 
virtual int seek (off_t offset, int origin)=0
 
virtual off_t tell (void)=0
 

Protected Member Functions

void clear (void)
 
void clearerr (void)
 
std::string encoding (void) const
 
void error (const std::string &msg)
 
void error (const std::string &who, const std::string &msg)
 
mach_info::float_format float_format (void) const
 
int mode (void) const
 

Private Member Functions

std::string do_gets (octave_idx_type max_len, bool &err, bool strip_newline, const std::string &who)
 
int do_numeric_printf_conv (std::ostream &os, const printf_format_elt *elt, int nsa, int sa_1, int sa_2, const octave_value &val, const std::string &who)
 
bool do_oscanf (const scanf_format_elt *elt, octave_value &, const std::string &who)
 
int do_printf (printf_format_list &fmt_list, const octave_value_list &args, const std::string &who)
 
octave_value do_scanf (scanf_format_list &fmt_list, octave_idx_type nr, octave_idx_type nc, bool one_elt_size_spec, octave_idx_type &count, const std::string &who)
 
octave_value do_textscan (const std::string &fmt, octave_idx_type ntimes, const octave_value_list &options, const std::string &who, octave_idx_type &count)
 
void field_width_error (const std::string &who) const
 
int flush (void)
 
std::string getl (octave_idx_type max_len, bool &err, const std::string &who)
 
std::string gets (octave_idx_type max_len, bool &err, const std::string &who)
 
void invalid_operation (const std::string &who, const char *rw)
 
octave_value_list oscanf (const std::string &fmt, const std::string &who)
 
int printf (const std::string &fmt, const octave_value_list &args, const std::string &who)
 
int puts (const std::string &s, const std::string &who)
 
octave_value scanf (const std::string &fmt, const Array< double > &size, octave_idx_type &count, const std::string &who)
 
off_t skipl (off_t count, bool &err, const std::string &who)
 

Private Attributes

std::string m_encoding
 
std::string m_errmsg
 
bool m_fail
 
mach_info::float_format m_flt_fmt
 
int m_mode
 
bool m_open_state
 

Friends

class stream
 

Detailed Description

Definition at line 64 of file oct-stream.h.

Constructor & Destructor Documentation

◆ base_stream() [1/2]

octave::base_stream::base_stream ( std::ios::openmode  arg_md = std::ios::in | std::ios::out,
mach_info::float_format  ff = mach_info::native_float_format (),
const std::string &  encoding = "utf-8" 
)
inline

Definition at line 72 of file oct-stream.h.

◆ base_stream() [2/2]

octave::base_stream::base_stream ( const base_stream &  )
delete

◆ ~base_stream()

virtual octave::base_stream::~base_stream ( void  )
virtualdefault

Member Function Documentation

◆ clear()

void octave::base_stream::clear ( void  )
protected

Definition at line 4002 of file oct-stream.cc.

References m_errmsg, and m_fail.

Referenced by error().

◆ clearerr()

void octave::base_stream::clearerr ( void  )
protected

Definition at line 4009 of file oct-stream.cc.

References input_stream(), and output_stream().

◆ close()

void octave::base_stream::close ( void  )
inline

Definition at line 124 of file oct-stream.h.

◆ do_close()

virtual void octave::base_stream::do_close ( void  )
inlinevirtual

Reimplemented in octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >, and octave_fstream.

Definition at line 122 of file oct-stream.h.

◆ do_gets()

std::string octave::base_stream::do_gets ( octave_idx_type  max_len,
bool &  err,
bool  strip_newline,
const std::string &  who 
)
private

Definition at line 4025 of file oct-stream.cc.

References octave::__get_interpreter__(), encoding(), error(), file_number(), input_stream(), octave::interpreter::interactive(), invalid_operation(), retval, and octave::string::u8_from_encoding().

Referenced by do_oscanf(), do_scanf(), getl(), and gets().

◆ do_numeric_printf_conv()

int octave::base_stream::do_numeric_printf_conv ( std::ostream &  os,
const printf_format_elt *  elt,
int  nsa,
int  sa_1,
int  sa_2,
const octave_value &  val,
const std::string &  who 
)
private

Definition at line 5746 of file oct-stream.cc.

References octave::do_printf_conv(), octave_value::double_value(), encoding(), error(), octave::printf_format_elt::flags, octave_value::int64_scalar_value(), octave::is_nan_or_inf(), lo_ieee_is_NA, lo_ieee_isinf, octave::ok_for_signed_int_conv(), octave::ok_for_unsigned_int_conv(), octave::printf_format_elt::prec, retval, octave::switch_to_g_format(), octave::printf_format_elt::text, octave::printf_format_elt::type, octave_value::uint64_scalar_value(), and octave_int< T >::value().

Referenced by do_printf().

◆ do_oscanf()

bool octave::base_stream::do_oscanf ( const scanf_format_elt *  elt,
octave_value &  retval,
const std::string &  who 
)
private

Definition at line 5076 of file oct-stream.cc.

References octave::__get_interpreter__(), BEGIN_C_CONVERSION, BEGIN_CHAR_CLASS_CONVERSION, BEGIN_S_CONVERSION, octave::scanf_format_elt::discard, do_gets(), DO_LITERAL_CONVERSION, DO_PCT_CONVERSION, DO_WHITESPACE_CONVERSION, error(), octave::application::forced_interactive(), input_stream(), octave::interpreter::interactive(), octave::scanf_format_elt::literal_conversion, octave::scanf_format_elt::modifier, name(), octave::octave_scan(), ok(), retval, octave::scanf_format_elt::text, octave::scanf_format_elt::type, and octave::scanf_format_elt::whitespace_conversion.

Referenced by oscanf().

◆ do_printf()

int octave::base_stream::do_printf ( printf_format_list &  fmt_list,
const octave_value_list &  args,
const std::string &  who 
)
private

Definition at line 5873 of file oct-stream.cc.

References octave::printf_format_elt::args, do_numeric_printf_conv(), octave::do_printf_string(), encoding(), error(), octave::printf_value_cache::exhausted(), field_width_error(), octave::printf_format_list::first(), octave::printf_format_elt::fw, octave::printf_value_cache::get_next_value(), octave::printf_value_cache::int_value(), invalid_operation(), octave_value::is_string(), octave_value::isempty(), octave::printf_format_list::next(), octave::printf_format_list::num_conversions(), output_stream(), octave::printf_format_elt::prec, retval, octave_value::string_value(), octave::printf_format_elt::text, octave::printf_format_elt::type, and octave::string::u8_to_encoding().

Referenced by printf().

◆ do_scanf()

octave_value octave::base_stream::do_scanf ( scanf_format_list &  fmt_list,
octave_idx_type  nr,
octave_idx_type  nc,
bool  one_elt_size_spec,
octave_idx_type &  count,
const std::string &  who 
)
private

Definition at line 4644 of file oct-stream.cc.

References octave::__get_interpreter__(), octave::scanf_format_list::all_character_conversions(), BEGIN_C_CONVERSION, BEGIN_CHAR_CLASS_CONVERSION, BEGIN_S_CONVERSION, octave::scanf_format_elt::discard, do_gets(), DO_LITERAL_CONVERSION, DO_PCT_CONVERSION, octave::do_scanf_conv(), DO_WHITESPACE_CONVERSION, error(), file_number(), FINISH_CHARACTER_CONVERSION, octave::scanf_format_list::first(), octave::application::forced_interactive(), Array< T >::fortran_vec(), input_stream(), octave::interpreter::interactive(), octave::scanf_format_list::length(), octave::scanf_format_elt::literal_conversion, octave::scanf_format_elt::modifier, name(), octave::scanf_format_list::next(), octave::scanf_format_elt::null, octave::scanf_format_list::num_conversions(), ok(), panic_impossible, Matrix::resize(), retval, octave::scanf_format_elt::text, octave::scanf_format_elt::type, and octave::scanf_format_elt::whitespace_conversion.

Referenced by scanf().

◆ do_textscan()

octave_value octave::base_stream::do_textscan ( const std::string &  fmt,
octave_idx_type  ntimes,
const octave_value_list &  options,
const std::string &  who,
octave_idx_type &  count 
)
private

Definition at line 5366 of file oct-stream.cc.

References octave::__get_interpreter__(), encoding(), error(), file_number(), input_stream(), octave::interpreter::interactive(), invalid_operation(), retval, and scanner.

◆ encoding()

std::string octave::base_stream::encoding ( void  ) const
inlineprotected

Definition at line 159 of file oct-stream.h.

Referenced by octave_istrstream::create(), octave_iprocstream::create(), octave_oprocstream::create(), octave_ostrstream::create(), do_gets(), do_numeric_printf_conv(), do_printf(), and do_textscan().

◆ eof()

virtual bool octave::base_stream::eof ( void  ) const
pure virtual

Implemented in octave_ostrstream, octave_istrstream, octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >, octave_ostream, octave_istream, octave_base_iostream, and octave_fstream.

◆ error() [1/3]

std::string octave::base_stream::error ( bool  clear,
int &  err_num 
)

Definition at line 6050 of file oct-stream.cc.

References clear(), m_errmsg, and m_fail.

Referenced by octave_fstream::octave_fstream(), do_gets(), do_numeric_printf_conv(), do_oscanf(), do_printf(), do_scanf(), do_textscan(), field_width_error(), invalid_operation(), octave_base_iostream::invalid_operation(), oscanf(), printf(), puts(), scanf(), octave_fstream::seek(), octave_base_strstream::seek(), skipl(), octave_fstream::tell(), and octave_base_strstream::tell().

◆ error() [2/3]

void octave::base_stream::error ( const std::string &  msg)
protected

Definition at line 3988 of file oct-stream.cc.

References m_errmsg, and m_fail.

◆ error() [3/3]

void octave::base_stream::error ( const std::string &  who,
const std::string &  msg 
)
protected

Definition at line 3995 of file oct-stream.cc.

References m_errmsg, and m_fail.

◆ field_width_error()

void octave::base_stream::field_width_error ( const std::string &  who) const
private

Definition at line 5866 of file oct-stream.cc.

References error().

Referenced by do_printf().

◆ file_number()

virtual int octave::base_stream::file_number ( void  ) const
inlinevirtual

Reimplemented in octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, and octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >.

Definition at line 133 of file oct-stream.h.

References name.

Referenced by do_gets(), do_scanf(), do_textscan(), and skipl().

◆ float_format()

mach_info::float_format octave::base_stream::float_format ( void  ) const
inlineprotected

Definition at line 157 of file oct-stream.h.

◆ flush()

int octave::base_stream::flush ( void  )
private

Definition at line 5398 of file oct-stream.cc.

References invalid_operation(), output_stream(), and retval.

◆ getl()

std::string octave::base_stream::getl ( octave_idx_type  max_len,
bool &  err,
const std::string &  who 
)
private

Definition at line 4129 of file oct-stream.cc.

References do_gets().

◆ gets()

std::string octave::base_stream::gets ( octave_idx_type  max_len,
bool &  err,
const std::string &  who 
)
private

Definition at line 4136 of file oct-stream.cc.

References do_gets().

◆ input_stream()

virtual std::istream* octave::base_stream::input_stream ( void  )
inlinevirtual

Reimplemented in octave_ostrstream, octave_istrstream, octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >, octave_ostream, octave_istream, and octave_fstream.

Definition at line 110 of file oct-stream.h.

Referenced by clearerr(), do_gets(), do_oscanf(), do_scanf(), do_textscan(), oscanf(), scanf(), and skipl().

◆ invalid_operation()

void octave::base_stream::invalid_operation ( const std::string &  who,
const char *  rw 
)
private

Definition at line 6063 of file oct-stream.cc.

References error().

Referenced by do_gets(), do_printf(), do_textscan(), flush(), oscanf(), puts(), scanf(), and skipl().

◆ is_open()

bool octave::base_stream::is_open ( void  ) const
inline

Definition at line 120 of file oct-stream.h.

◆ mode()

int octave::base_stream::mode ( void  ) const
inlineprotected

Definition at line 155 of file oct-stream.h.

Referenced by octave_fstream::input_stream(), and octave_fstream::output_stream().

◆ name()

virtual std::string octave::base_stream::name ( void  ) const
pure virtual

Implemented in octave_base_strstream, octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >, octave_base_iostream, and octave_fstream.

Referenced by do_oscanf(), and do_scanf().

◆ ok()

bool octave::base_stream::ok ( void  ) const
inline

Definition at line 147 of file oct-stream.h.

Referenced by do_oscanf(), do_scanf(), and oscanf().

◆ operator=()

base_stream& octave::base_stream::operator= ( const base_stream &  )
delete

◆ oscanf()

octave_value_list octave::base_stream::oscanf ( const std::string &  fmt,
const std::string &  who 
)
private

Definition at line 5292 of file oct-stream.cc.

References do_oscanf(), error(), octave::scanf_format_list::first(), input_stream(), invalid_operation(), octave_value::is_defined(), len, octave::scanf_format_list::length(), octave::scanf_format_list::next(), octave::scanf_format_list::num_conversions(), ok(), Array< T >::resize(), and retval.

◆ output_stream()

virtual std::ostream* octave::base_stream::output_stream ( void  )
inlinevirtual

Reimplemented in octave_ostrstream, octave_istrstream, octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >, octave_ostream, octave_istream, and octave_fstream.

Definition at line 116 of file oct-stream.h.

Referenced by clearerr(), do_printf(), flush(), and puts().

◆ printf()

int octave::base_stream::printf ( const std::string &  fmt,
const octave_value_list &  args,
const std::string &  who 
)
private

Definition at line 5998 of file oct-stream.cc.

References do_printf(), error(), and octave::printf_format_list::num_conversions().

◆ puts()

int octave::base_stream::puts ( const std::string &  s,
const std::string &  who 
)
private

Definition at line 6011 of file oct-stream.cc.

References error(), invalid_operation(), output_stream(), and retval.

◆ scanf()

octave_value octave::base_stream::scanf ( const std::string &  fmt,
const Array< double > &  size,
octave_idx_type &  count,
const std::string &  who 
)
private

Definition at line 5042 of file oct-stream.cc.

References do_scanf(), error(), octave::get_size(), input_stream(), invalid_operation(), octave::scanf_format_list::num_conversions(), and retval.

◆ seek()

virtual int octave::base_stream::seek ( off_t  offset,
int  origin 
)
pure virtual

Implemented in octave_base_strstream, octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >, octave_base_iostream, and octave_fstream.

◆ skipl()

off_t octave::base_stream::skipl ( off_t  count,
bool &  err,
const std::string &  who 
)
private

Definition at line 4143 of file oct-stream.cc.

References octave::__get_interpreter__(), error(), file_number(), input_stream(), octave::interpreter::interactive(), and invalid_operation().

◆ tell()

virtual off_t octave::base_stream::tell ( void  )
pure virtual

Implemented in octave_istrstream, octave_base_strstream, octave_tstdiostream< BUF_T, STREAM_T, FILE_T >, octave_tstdiostream< c_file_ptr_buf, io_c_file_ptr_stream, FILE * >, octave_tstdiostream< c_zfile_ptr_buf, io_c_zfile_ptr_stream, gzFile >, octave_base_iostream, and octave_fstream.

Friends And Related Function Documentation

◆ stream

friend class stream
friend

Definition at line 68 of file oct-stream.h.

Member Data Documentation

◆ m_encoding

std::string octave::base_stream::m_encoding
private

Definition at line 184 of file oct-stream.h.

◆ m_errmsg

std::string octave::base_stream::m_errmsg
private

Definition at line 193 of file oct-stream.h.

Referenced by clear(), and error().

◆ m_fail

bool octave::base_stream::m_fail
private

Definition at line 187 of file oct-stream.h.

Referenced by clear(), and error().

◆ m_flt_fmt

mach_info::float_format octave::base_stream::m_flt_fmt
private

Definition at line 181 of file oct-stream.h.

◆ m_mode

int octave::base_stream::m_mode
private

Definition at line 178 of file oct-stream.h.

◆ m_open_state

bool octave::base_stream::m_open_state
private

Definition at line 190 of file oct-stream.h.

The documentation for this class was generated from the following files: