libMesh::ExodusII_IO_Helper::NamesData Class Reference

This class is useful for managing anything that requires a char ** input/output in ExodusII file. More...

#include <exodusII_io_helper.h>

Public Member Functions
	NamesData (size_t n_strings, size_t string_length)
	Constructor. More...
void	push_back_entry (const std::string &name)
	Adds another name to the current data table. More...
char **	get_char_star_star ()
	Provide access to the underlying C data table. More...
char *	get_char_star (int i)
	Provide access to the i'th underlying char *. More...

Private Attributes
std::vector< std::vector< char > >	data_table
std::vector< char * >	data_table_pointers
size_t	counter
size_t	table_size

Detailed Description

This class is useful for managing anything that requires a char ** input/output in ExodusII file.

You must know the number of strings and the length of each one at the time you create it.

Definition at line 984 of file exodusII_io_helper.h.

Constructor & Destructor Documentation

NamesData()

libMesh::ExodusII_IO_Helper::NamesData::NamesData ( size_t  n_strings, size_t  string_length  )

explicit

Constructor.

Allocates enough storage to hold n_strings of length string_length. (Actually allocates string_length+1 characters per string to account for the trailing '\0' character.)

Definition at line 3356 of file exodusII_io_helper.C.

                                                                             :
  data_table(n_strings),
  data_table_pointers(n_strings),
  counter(0),
  table_size(n_strings)
{
  for (size_t i=0; i<n_strings; ++i)
    {
      data_table[i].resize(string_length + 1);
 
      // Properly terminate these C-style strings, just to be safe.
      data_table[i][0] = '\0';
 
      // Set pointer into the data_table
      data_table_pointers[i] = data_table[i].data();
    }
}

References data_table, and data_table_pointers.

Member Function Documentation

get_char_star()

char * libMesh::ExodusII_IO_Helper::NamesData::get_char_star

(

int

i

)

Provide access to the i'th underlying char *.

Definition at line 3399 of file exodusII_io_helper.C.

{
  if (static_cast<unsigned>(i) >= table_size)
    libmesh_error_msg("Requested char * " << i << " but only have " << table_size << "!");
 
  else
    return data_table[i].data();
}

Referenced by libMesh::ExodusII_IO_Helper::read_var_names_impl(), and libMesh::ExodusII_IO_Helper::write_var_names_impl().

get_char_star_star()

char ** libMesh::ExodusII_IO_Helper::NamesData::get_char_star_star

(

)

Provide access to the underlying C data table.

Definition at line 3392 of file exodusII_io_helper.C.

{
  return data_table_pointers.data();
}

Referenced by libMesh::ExodusII_IO_Helper::read_var_names_impl(), libMesh::Nemesis_IO_Helper::write_elements(), libMesh::ExodusII_IO_Helper::write_elements(), libMesh::ExodusII_IO_Helper::write_information_records(), and libMesh::ExodusII_IO_Helper::write_var_names_impl().

push_back_entry()

void libMesh::ExodusII_IO_Helper::NamesData::push_back_entry

(

const std::string &

name

)

Adds another name to the current data table.

Definition at line 3376 of file exodusII_io_helper.C.

{
  libmesh_assert_less (counter, table_size);
 
  // 1.) Copy the C++ string into the vector<char>...
  size_t num_copied = name.copy(data_table[counter].data(), data_table[counter].size()-1);
 
  // 2.) ...And null-terminate it.
  data_table[counter][num_copied] = '\0';
 
  // Go to next row
  ++counter;
}

References data, and libMesh::Quality::name().

Referenced by libMesh::Nemesis_IO_Helper::write_elements(), libMesh::ExodusII_IO_Helper::write_elements(), libMesh::ExodusII_IO_Helper::write_information_records(), libMesh::ExodusII_IO_Helper::write_sidesets(), and libMesh::ExodusII_IO_Helper::write_var_names_impl().

Member Data Documentation

counter

size_t libMesh::ExodusII_IO_Helper::NamesData::counter

private

Definition at line 1015 of file exodusII_io_helper.h.

data_table

std::vector<std::vector<char> > libMesh::ExodusII_IO_Helper::NamesData::data_table

private

Definition at line 1012 of file exodusII_io_helper.h.

Referenced by NamesData().

data_table_pointers

std::vector<char *> libMesh::ExodusII_IO_Helper::NamesData::data_table_pointers

private

Definition at line 1013 of file exodusII_io_helper.h.

Referenced by NamesData().

table_size

size_t libMesh::ExodusII_IO_Helper::NamesData::table_size

private

Definition at line 1016 of file exodusII_io_helper.h.

---

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

• include/mesh/exodusII_io_helper.h
• src/mesh/exodusII_io_helper.C