GNU Octave  4.4.1
A high-level interpreted language, primarily intended for numerical computations, mostly compatible with Matlab
Public Member Functions | Static Public Member Functions | Protected Member Functions | Private Member Functions | Static Private Member Functions | Private Attributes | Static Private Attributes | List of all members
octave::sys::env Class Reference

#include "oct-env.h"

Collaboration diagram for octave::sys::env:
Collaboration graph
[legend]

Public Member Functions

 env (const env &)=delete
 
env & operator= (const env &)=delete
 

Static Public Member Functions

static bool absolute_pathname (const std::string &s)
 
static std::string base_pathname (const std::string &s)
 
static bool chdir (const std::string &newdir)
 
static std::string get_current_directory (void)
 
static std::string get_home_directory (void)
 
static std::string get_host_name (void)
 
static std::string get_program_invocation_name (void)
 
static std::string get_program_name (void)
 
static std::string get_temp_directory (void)
 
static std::string get_user_name (void)
 
static std::string getenv (const std::string &name)
 
static bool have_x11_display (void)
 
static std::string make_absolute (const std::string &s, const std::string &dot_path=get_current_directory())
 
static std::string polite_directory_format (const std::string &name)
 
static void putenv (const std::string &name, const std::string &value)
 
static bool rooted_relative_pathname (const std::string &s)
 
static void set_program_name (const std::string &s)
 

Protected Member Functions

 env (void)
 

Private Member Functions

bool do_absolute_pathname (const std::string &s) const
 
std::string do_base_pathname (const std::string &s) const
 
bool do_chdir (const std::string &newdir)
 
std::string do_get_home_directory (void) const
 
std::string do_get_host_name (void) const
 
std::string do_get_temp_directory (void) const
 
std::string do_get_user_name (void) const
 
std::string do_getcwd (void) const
 
std::string do_getenv (const std::string &name) const
 
std::string do_make_absolute (const std::string &s, const std::string &dot_path) const
 
std::string do_polite_directory_format (const std::string &name) const
 
void do_putenv (const std::string &name, const std::string &value) const
 
bool do_rooted_relative_pathname (const std::string &s) const
 
void do_set_program_name (const std::string &s) const
 
void error (int) const
 
void error (const std::string &) const
 
void pathname_backup (std::string &path, int n) const
 

Static Private Member Functions

static void cleanup_instance (void)
 
static bool instance_ok (void)
 

Private Attributes

std::string current_directory
 
bool follow_symbolic_links
 
std::string host_name
 
std::string prog_invocation_name
 
std::string prog_name
 
std::string user_name
 
bool verbatim_pwd
 

Static Private Attributes

static env * instance = nullptr
 

Detailed Description

Definition at line 34 of file oct-env.h.

Constructor & Destructor Documentation

◆ env() [1/2]

octave::sys::env::env ( void  )
protected

Definition at line 64 of file oct-env.cc.

References do_get_host_name(), do_get_user_name(), and do_getcwd().

Referenced by instance_ok().

◆ env() [2/2]

octave::sys::env::env ( const env &  )
delete

Member Function Documentation

◆ absolute_pathname()

bool octave::sys::env::absolute_pathname ( const std::string &  s)
static

Definition at line 108 of file oct-env.cc.

References do_absolute_pathname(), instance, instance_ok(), and s.

Referenced by octave::load_path::find_all_first_of(), octave::load_path::find_dir(), octave::load_path::find_file(), octave::load_path::find_first_of(), octave::load_path::find_matching_dirs(), octave::load_path::dir_info::initialize(), kpse_absolute_p(), octave::out_of_date_check(), and prepend_home_dir().

◆ base_pathname()

std::string octave::sys::env::base_pathname ( const std::string &  s)
static

Definition at line 122 of file oct-env.cc.

References do_base_pathname(), instance, instance_ok(), and s.

Referenced by octave::xzip().

◆ chdir()

bool octave::sys::env::chdir ( const std::string &  newdir)
static

Definition at line 256 of file oct-env.cc.

References do_chdir(), instance, and instance_ok().

Referenced by octave_change_to_directory().

◆ cleanup_instance()

static void octave::sys::env::cleanup_instance ( void  )
inlinestaticprivate

Definition at line 128 of file oct-env.h.

Referenced by instance_ok().

◆ do_absolute_pathname()

bool octave::sys::env::do_absolute_pathname ( const std::string &  s) const
private

Definition at line 318 of file oct-env.cc.

References octave::sys::file_ops::is_dir_sep(), and s.

Referenced by absolute_pathname(), do_base_pathname(), and do_make_absolute().

◆ do_base_pathname()

std::string octave::sys::env::do_base_pathname ( const std::string &  s) const
private

Definition at line 367 of file oct-env.cc.

References octave::sys::file_ops::dir_sep_chars(), do_absolute_pathname(), do_rooted_relative_pathname(), and s.

Referenced by base_pathname().

◆ do_chdir()

bool octave::sys::env::do_chdir ( const std::string &  newdir)
private

Definition at line 543 of file oct-env.cc.

References octave::sys::chdir(), current_directory, do_getcwd(), do_make_absolute(), follow_symbolic_links, octave::sys::file_ops::is_dir_sep(), retval, string, and tmp.

Referenced by chdir().

◆ do_get_home_directory()

std::string octave::sys::env::do_get_home_directory ( void  ) const
private

Definition at line 475 of file oct-env.cc.

References octave::sys::password::dir(), octave::sys::file_ops::dir_sep_str(), do_getenv(), octave::sys::password::getpwuid(), octave::sys::getuid(), and string.

Referenced by do_polite_directory_format(), and get_home_directory().

◆ do_get_host_name()

std::string octave::sys::env::do_get_host_name ( void  ) const
private

Definition at line 517 of file oct-env.cc.

References host_name, and octave_gethostname_wrapper().

Referenced by env(), and get_host_name().

◆ do_get_temp_directory()

std::string octave::sys::env::do_get_temp_directory ( void  ) const
private

Definition at line 192 of file oct-env.cc.

References do_getenv(), and string.

Referenced by get_temp_directory().

◆ do_get_user_name()

std::string octave::sys::env::do_get_user_name ( void  ) const
private

Definition at line 503 of file oct-env.cc.

References octave::sys::password::getpwuid(), octave::sys::getuid(), octave::sys::password::name(), and user_name.

Referenced by env(), and get_user_name().

◆ do_getcwd()

std::string octave::sys::env::do_getcwd ( void  ) const
private

Definition at line 460 of file oct-env.cc.

References current_directory, follow_symbolic_links, octave::sys::getcwd(), and verbatim_pwd.

Referenced by do_chdir(), env(), and get_current_directory().

◆ do_getenv()

std::string octave::sys::env::do_getenv ( const std::string &  name) const
private

Definition at line 532 of file oct-env.cc.

References getenv(), name, and value.

Referenced by do_get_home_directory(), do_get_temp_directory(), and getenv().

◆ do_make_absolute()

std::string octave::sys::env::do_make_absolute ( const std::string &  s,
const std::string &  dot_path 
) const
private

Definition at line 384 of file oct-env.cc.

References octave::sys::file_ops::dir_sep_chars(), octave::sys::file_ops::dir_sep_str(), do_absolute_pathname(), i, octave::sys::file_ops::is_dir_sep(), pathname_backup(), s, and string.

Referenced by do_chdir(), and make_absolute().

◆ do_polite_directory_format()

std::string octave::sys::env::do_polite_directory_format ( const std::string &  name) const
private

Definition at line 297 of file oct-env.cc.

References do_get_home_directory(), octave::sys::file_ops::is_dir_sep(), name, retval, and string.

Referenced by polite_directory_format().

◆ do_putenv()

void octave::sys::env::do_putenv ( const std::string &  name,
const std::string &  value 
) const
private

◆ do_rooted_relative_pathname()

bool octave::sys::env::do_rooted_relative_pathname ( const std::string &  s) const
private

Definition at line 339 of file oct-env.cc.

References octave::sys::file_ops::is_dir_sep(), and s.

Referenced by do_base_pathname(), and rooted_relative_pathname().

◆ do_set_program_name()

void octave::sys::env::do_set_program_name ( const std::string &  s) const
private

Definition at line 263 of file oct-env.cc.

References octave::sys::file_ops::dir_sep_chars(), initialized, octave_set_program_name_wrapper(), prog_invocation_name, prog_name, s, and strsave().

Referenced by set_program_name().

◆ error() [1/2]

void octave::sys::env::error ( int  err_num) const
private

Definition at line 600 of file oct-env.cc.

◆ error() [2/2]

void octave::sys::env::error ( const std::string &  s) const
private

Definition at line 606 of file oct-env.cc.

References s.

◆ get_current_directory()

std::string octave::sys::env::get_current_directory ( void  )
static

Definition at line 136 of file oct-env.cc.

References do_getcwd(), instance, and instance_ok().

Referenced by initial_class_path(), and octave_change_to_directory().

◆ get_home_directory()

std::string octave::sys::env::get_home_directory ( void  )
static

Definition at line 143 of file oct-env.cc.

References do_get_home_directory(), instance, and instance_ok().

Referenced by default_history_file(), initial_class_path(), kpse_tilde_expand(), octave::files_dock_widget::popdownmenu_home(), and tilde_expand_word().

◆ get_host_name()

std::string octave::sys::env::get_host_name ( void  )
static

Definition at line 185 of file oct-env.cc.

References do_get_host_name(), instance, and instance_ok().

Referenced by default_history_timestamp_format(), and default_save_header_format().

◆ get_program_invocation_name()

std::string octave::sys::env::get_program_invocation_name ( void  )
static

Definition at line 164 of file oct-env.cc.

References instance, instance_ok(), and prog_invocation_name.

Referenced by maybe_initialize_magick().

◆ get_program_name()

std::string octave::sys::env::get_program_name ( void  )
static

Definition at line 157 of file oct-env.cc.

References instance, instance_ok(), and prog_name.

◆ get_temp_directory()

std::string octave::sys::env::get_temp_directory ( void  )
static

Definition at line 150 of file oct-env.cc.

References do_get_temp_directory(), instance, and instance_ok().

Referenced by octave::sys::tempnam().

◆ get_user_name()

std::string octave::sys::env::get_user_name ( void  )
static

Definition at line 178 of file oct-env.cc.

References do_get_user_name(), instance, and instance_ok().

Referenced by default_history_timestamp_format(), and default_save_header_format().

◆ getenv()

std::string octave::sys::env::getenv ( const std::string &  name)
static

Definition at line 235 of file oct-env.cc.

References do_getenv(), instance, instance_ok(), and name.

Referenced by append_to_shell_path(), octave::curl_transfer::curl_transfer(), default_history_file(), default_history_size(), default_pager(), octave::default_qt_settings_file(), octave::ft_manager::do_get_font(), do_getenv(), octave::gui_application::execute(), expand(), octave::resource_manager::get_gui_translation_dir(), get_P_tmpdir(), have_gnuplot_binary(), have_x11_display(), octave::directory_path::init(), octave::environment::init_editor(), octave::environment::init_exec_path(), octave::environment::init_image_path(), initial_java_dir(), octave::load_path::initialize(), initialize_history(), initialize_jvm(), kpse_expand_kpse_dot(), set_local_site_defaults_file(), set_octave_home(), and set_site_defaults_file().

◆ have_x11_display()

bool octave::sys::env::have_x11_display ( void  )
static

Definition at line 248 of file oct-env.cc.

References getenv(), and string.

◆ instance_ok()

bool octave::sys::env::instance_ok ( void  )
staticprivate

Definition at line 81 of file oct-env.cc.

References singleton_cleanup_list::add(), cleanup_instance(), env(), instance, and retval.

Referenced by absolute_pathname(), base_pathname(), chdir(), get_current_directory(), get_home_directory(), get_host_name(), get_program_invocation_name(), get_program_name(), get_temp_directory(), get_user_name(), getenv(), make_absolute(), polite_directory_format(), rooted_relative_pathname(), and set_program_name().

◆ make_absolute()

std::string octave::sys::env::make_absolute ( const std::string &  s,
const std::string &  dot_path = get_current_directory () 
)
static

Definition at line 129 of file oct-env.cc.

References do_make_absolute(), instance, instance_ok(), and s.

Referenced by octave::tree_evaluator::echo(), octave::load_path::find_dir(), octave::load_path::find_matching_dirs(), octave::load_path::dir_info::initialize(), make_absolute(), read_mat5_binary_element(), search_path_for_all_files(), search_path_for_file(), octave_fcn_handle::set_fcn(), and octave::load_path::dir_info::update().

◆ operator=()

env& octave::sys::env::operator= ( const env &  )
delete

◆ pathname_backup()

void octave::sys::env::pathname_backup ( std::string &  path,
int  n 
) const
private

Definition at line 578 of file oct-env.cc.

References i, and octave::sys::file_ops::is_dir_sep().

Referenced by do_make_absolute().

◆ polite_directory_format()

std::string octave::sys::env::polite_directory_format ( const std::string &  name)
static

Definition at line 101 of file oct-env.cc.

References do_polite_directory_format(), instance, instance_ok(), and name.

◆ putenv()

void octave::sys::env::putenv ( const std::string &  name,
const std::string &  value 
)
static

Definition at line 242 of file oct-env.cc.

References name, octave_putenv(), and value.

Referenced by append_to_shell_path(), octave::gui_application::execute(), and Fsetenv().

◆ rooted_relative_pathname()

bool octave::sys::env::rooted_relative_pathname ( const std::string &  s)
static

Definition at line 115 of file oct-env.cc.

References do_rooted_relative_pathname(), instance, instance_ok(), and s.

Referenced by octave::load_path::find_all_first_of(), octave::load_path::find_dir(), octave::load_path::find_file(), octave::load_path::find_first_of(), octave::load_path::find_matching_dirs(), and kpse_absolute_p().

◆ set_program_name()

void octave::sys::env::set_program_name ( const std::string &  s)
static

Definition at line 171 of file oct-env.cc.

References do_set_program_name(), instance, instance_ok(), and s.

Referenced by main().

Member Data Documentation

◆ current_directory

std::string octave::sys::env::current_directory
mutableprivate

Definition at line 139 of file oct-env.h.

Referenced by do_chdir(), and do_getcwd().

◆ follow_symbolic_links

bool octave::sys::env::follow_symbolic_links
private

Definition at line 132 of file oct-env.h.

Referenced by do_chdir(), and do_getcwd().

◆ host_name

std::string octave::sys::env::host_name
mutableprivate

Definition at line 148 of file oct-env.h.

Referenced by do_get_host_name().

◆ instance

env * octave::sys::env::instance = nullptr
staticprivate

Definition at line 126 of file oct-env.h.

Referenced by absolute_pathname(), base_pathname(), chdir(), get_current_directory(), get_home_directory(), get_host_name(), get_program_invocation_name(), get_program_name(), get_temp_directory(), get_user_name(), getenv(), instance_ok(), make_absolute(), polite_directory_format(), rooted_relative_pathname(), and set_program_name().

◆ prog_invocation_name

std::string octave::sys::env::prog_invocation_name
mutableprivate

Definition at line 144 of file oct-env.h.

Referenced by do_set_program_name(), and get_program_invocation_name().

◆ prog_name

std::string octave::sys::env::prog_name
mutableprivate

Definition at line 142 of file oct-env.h.

Referenced by do_set_program_name(), and get_program_name().

◆ user_name

std::string octave::sys::env::user_name
mutableprivate

Definition at line 146 of file oct-env.h.

Referenced by do_get_user_name().

◆ verbatim_pwd

bool octave::sys::env::verbatim_pwd
private

Definition at line 136 of file oct-env.h.

Referenced by do_getcwd().

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