This class handles sparse matrix_char objects as shared handles. More...

#include <spmatrix_char.hpp>

Collaboration diagram for gsl::spmatrix_char:

Public Types
enum	{ COO = GSL_SPMATRIX_COO , CSC = GSL_SPMATRIX_CSC , CSR = GSL_SPMATRIX_CSR , TRIPLET = GSL_SPMATRIX_TRIPLET , CCS = GSL_SPMATRIX_CCS , CRS = GSL_SPMATRIX_CRS }
	Reference to GSL_SPMATRIX constants. More...

Public Member Functions
	spmatrix_char ()
	The default constructor is only really useful for assigning to. More...

	spmatrix_char (size_t const n1, size_t const n2)
	This constructor creates a new matrix_char with n1 rows and n2 columns. More...

	spmatrix_char (size_t const n1, size_t const n2, size_t nzmax, size_t sptype)
	This constructor creates a new matrix_char with n1 rows and n2 columns. More...

	spmatrix_char (gsl_spmatrix_char *v)
	Could construct from a gsl_spmatrix_char. More...

	spmatrix_char (std::initializer_list< std::initializer_list< char > > initializer_list)
	Could construct from a std::initializer_list in C++11 and later. More...

	spmatrix_char (spmatrix_char const &v)
	The copy constructor. More...

spmatrix_char &	operator= (spmatrix_char const &v)
	The assignment operator. More...

spmatrix_char	clone () const
	The clone function. More...

	~spmatrix_char ()
	The destructor only deletes the pointers if count reaches zero. More...

void	wrap_gsl_spmatrix_char_without_ownership (gsl_spmatrix_char *v)
	This function is intended mainly for internal use. More...

void	reset ()
	Stop sharing ownership of the shared pointer. More...

	spmatrix_char (spmatrix_char &&v)
	Move constructor. More...

spmatrix_char &	operator= (spmatrix_char &&v)
	Move operator. More...

size_t	size1 () const
	The number of rows of the matrix_char. More...

size_t	size2 () const
	The number of columns of the matrix_char. More...

size_t	nzmax () const
	The maximum number of nonzero elements. More...

int	sptype () const
	The type of the spmatrix_char. More...

char *	data ()
	Give access to the data block. More...

char const *	data () const
	Give access to the data block. More...

void	swap (spmatrix_char &m)
	Swap two spmatrix_char objects. More...

int	realloc (size_t const nzmax)
	C++ version of gsl_spmatrix_char_realloc(). More...

size_t	nnz () const
	C++ version of gsl_spmatrix_char_nnz(). More...

char const *	type () const
	C++ version of gsl_spmatrix_char_type(). More...

int	set_zero ()
	C++ version of gsl_spmatrix_char_set_zero(). More...

int	tree_rebuild ()
	C++ version of gsl_spmatrix_char_tree_rebuild(). More...

spmatrix_char	csc () const
	C++ version of gsl_spmatrix_char_csc(). More...

spmatrix_char	csr () const
	C++ version of gsl_spmatrix_char_csr(). More...

spmatrix_char	compress (int const sptype) const
	C++ version of gsl_spmatrix_char_compress(). More...

spmatrix_char	compcol () const
	C++ version of gsl_spmatrix_char_compcol(). More...

spmatrix_char	ccs () const
	C++ version of gsl_spmatrix_char_ccs(). More...

spmatrix_char	crs () const
	C++ version of gsl_spmatrix_char_crs(). More...

int	memcpy (spmatrix_char &dest) const
	C++ version of gsl_spmatrix_char_memcpy(). More...

int	fprintf (FILE stream, char const format) const
	C++ version of gsl_spmatrix_char_fprintf(). More...

int	fwrite (FILE *stream) const
	C++ version of gsl_spmatrix_char_fwrite(). More...

int	fread (FILE *stream)
	C++ version of gsl_spmatrix_char_fread(). More...

char	get (size_t const i, size_t const j) const
	C++ version of gsl_spmatrix_char_get(). More...

int	set (size_t const i, size_t const j, char const x)
	C++ version of gsl_spmatrix_char_set(). More...

char *	ptr (size_t const i, size_t const j) const
	C++ version of gsl_spmatrix_char_ptr(). More...

int	minmax (char &min_out, char &max_out) const
	C++ version of gsl_spmatrix_char_minmax(). More...

int	min_index (size_t &imin_out, size_t &jmin_out) const
	C++ version of gsl_spmatrix_char_min_index(). More...

int	scale (char const x)
	C++ version of gsl_spmatrix_char_scale(). More...

int	scale_columns (gsl::vector_char const &x)
	C++ version of gsl_spmatrix_char_scale_columns(). More...

int	scale_rows (gsl::vector_char const &x)
	C++ version of gsl_spmatrix_char_scale_rows(). More...

int	equal (spmatrix_char const &b) const
	C++ version of gsl_spmatrix_char_equal(). More...

int	transpose ()
	C++ version of gsl_spmatrix_char_transpose(). More...

int	transpose2 ()
	C++ version of gsl_spmatrix_char_transpose2(). More...

gsl_spmatrix_char *	get ()
	Get the gsl_spmatrix_char. More...

gsl_spmatrix_char const *	get () const
	Get the gsl_spmatrix_char. More...

bool	unique () const
	Find if this is the only object sharing the gsl_spmatrix_char. More...

size_t	use_count () const
	Find how many spmatrix_char objects share this pointer. More...

	operator bool () const
	Allow conversion to bool. More...

Static Public Member Functions
static int	realloc (size_t const nzmax, gsl::spmatrix_char &spMatrix)
	C++ version of gsl_spmatrix_char_realloc(): matches a function in gsl that is intended for internal use. More...

static size_t	nnz (spmatrix_char const &spMatrix)
	C++ version of gsl_spmatrix_char_nnz(). More...

static char const *	type (spmatrix_char const &spMatrix)
	C++ version of gsl_spmatrix_char_type(). More...

static int	set_zero (spmatrix_char &spMatrix)
	C++ version of gsl_spmatrix_char_set_zero(). More...

static int	tree_rebuild (spmatrix_char &spMatrix)
	C++ version of gsl_spmatrix_char_tree_rebuild(). More...

static spmatrix_char	csc (spmatrix_char const &spMatrix)
	C++ version of gsl_spmatrix_char_csc(). More...

static spmatrix_char	csr (spmatrix_char const &spMatrix)
	C++ version of gsl_spmatrix_char_csr(). More...

static spmatrix_char	compress (spmatrix_char const &spMatrix, int const sptype)
	C++ version of gsl_spmatrix_char_compress(). More...

static spmatrix_char	compcol (spmatrix_char const &spMatrix)
	C++ version of gsl_spmatrix_char_compcol(). More...

static spmatrix_char	ccs (spmatrix_char const &spMatrix)
	C++ version of gsl_spmatrix_char_ccs(). More...

static spmatrix_char	crs (spmatrix_char const &spMatrix)
	C++ version of gsl_spmatrix_char_crs(). More...

static int	memcpy (spmatrix_char &dest, spmatrix_char const &src)
	C++ version of gsl_spmatrix_char_memcpy(). More...

static int	fprintf (FILE stream, spmatrix_char const &spMatrix, char const format)
	C++ version of gsl_spmatrix_char_fprintf(). More...

static spmatrix_char	fscanf (FILE *stream)
	C++ version of gsl_spmatrix_char_fscanf(). More...

static int	fwrite (FILE *stream, spmatrix_char &spMatrix)
	C++ version of gsl_spmatrix_char_fwrite(). More...

static int	fread (FILE *stream, spmatrix_char &spMatrix)
	C++ version of gsl_spmatrix_char_fread(). More...

static int	add (spmatrix_char &c, spmatrix_char const &a, spmatrix_char const &b)
	C++ version of gsl_spmatrix_char_add(). More...

static spmatrix_char	add (spmatrix_char const &a, spmatrix_char const &b)
	C++ version of gsl_spmatrix_char_add(). More...

static int	add_to_dense (gsl::matrix_char &a, spmatrix_char const &b)
	C++ version of gsl_spmatrix_add_to_dense(). More...

static int	dense_add (gsl::matrix_char &a, spmatrix_char const &b)
	C++ version of gsl_spmatrix_dense_add(). More...

static int	dense_sub (gsl::matrix_char &a, spmatrix_char const &b)
	C++ version of gsl_spmatrix_dense_sub(). More...

static char	norm1 (gsl::spmatrix_char const &a)
	C++ version of gsl_spmatrix_char_norm1(). More...

static int	d2sp (gsl::spmatrix_char &S, gsl::matrix_char const &A)
	C++ version of gsl_spmatrix_char_d2sp(). More...

static int	sp2d (gsl::matrix_char &A, spmatrix_char const &S)
	C++ version of gsl_spmatrix_char_sp2d(). More...

static int	equal (spmatrix_char const &a, spmatrix_char const &b)
	C++ version of gsl_spmatrix_char_equal(). More...

static int	transpose (spmatrix_char &a)
	C++ version of gsl_spmatrix_char_transpose(). More...

static int	transpose2 (spmatrix_char &a)
	C++ version of gsl_spmatrix_char_transpose2(). More...

static int	transpose_memcpy (spmatrix_char &dest, spmatrix_char const &src)
	C++ version of gsl_spmatrix_char_transpose_memcpy(). More...

Private Attributes
gsl_spmatrix_char *	ccgsl_pointer
	The shared pointer. More...

size_t *	count
	The shared reference count. More...

Detailed Description

This class handles sparse matrix_char objects as shared handles.

It models a random access container so that STL functions work with matrix_char.

Definition at line 37 of file spmatrix_char.hpp.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Reference to GSL_SPMATRIX constants.

Enumerator
COO	GSL_SPMATRIX_COO.
CSC	GSL_SPMATRIX_CSC.
CSR	GSL_SPMATRIX_CSR.
TRIPLET	GSL_SPMATRIX_TRIPLET.
CCS	GSL_SPMATRIX_CCS.
CRS	GSL_SPMATRIX_CRS.

Definition at line 42 of file spmatrix_char.hpp.

Constructor & Destructor Documentation

◆ spmatrix_char() [1/7]

gsl::spmatrix_char::spmatrix_char ( )

inline

The default constructor is only really useful for assigning to.

Definition at line 59 of file spmatrix_char.hpp.

References ccgsl_pointer, and count.

Referenced by operator=(), and reset().

◆ spmatrix_char() [2/7]

gsl::spmatrix_char::spmatrix_char	(	size_t const	n1,
		size_t const	n2
	)

inlineexplicit

This constructor creates a new matrix_char with n1 rows and n2 columns.

Parameters

n1	The number of rows in the matrix_char
n2	The number of columns in the matrix_char

Definition at line 70 of file spmatrix_char.hpp.

References ccgsl_pointer, and count.

◆ spmatrix_char() [3/7]

gsl::spmatrix_char::spmatrix_char	(	size_t const	n1,
		size_t const	n2,
		size_t	nzmax,
		size_t	sptype
	)

inlineexplicit

This constructor creates a new matrix_char with n1 rows and n2 columns.

Parameters

n1	The number of rows in the matrix_char
n2	The number of columns in the matrix_char
nzmax	The maximum number of nonzero elements that will be added to the matrix_char
sptype	The storage format of the sparse matrix_char: one of gsl::spmatrix_char::COO, gsl::spmatrix_char::CSC or gsl::spmatrix_char::CSR

Definition at line 91 of file spmatrix_char.hpp.

References ccgsl_pointer, count, nzmax(), and sptype().

◆ spmatrix_char() [4/7]

gsl::spmatrix_char::spmatrix_char ( gsl_spmatrix_char * v )

inlineexplicit

Could construct from a gsl_spmatrix_char.

This is not usually a good idea. In this case you should not use gsl_spmatrix_char_free() to deallocate the memory.

Parameters

v	The matrix_char

Definition at line 110 of file spmatrix_char.hpp.

References ccgsl_pointer, and count.

◆ spmatrix_char() [5/7]

gsl::spmatrix_char::spmatrix_char ( std::initializer_list< std::initializer_list< char > > initializer_list )

inline

Could construct from a std::initializer_list in C++11 and later.

Parameters

initializer_list The initializer_list.

Definition at line 121 of file spmatrix_char.hpp.

References ccgsl_pointer, count, gsl::exception::GSL_EBADLEN, and set().

◆ spmatrix_char() [6/7]

gsl::spmatrix_char::spmatrix_char ( spmatrix_char const & v )

inline

The copy constructor.

This shares the matrix_char. Use clone() if you want a full copy.

Parameters

v	The spmatrix_char to copy.

Definition at line 154 of file spmatrix_char.hpp.

References count.

◆ ~spmatrix_char()

gsl::spmatrix_char::~spmatrix_char ( )

inline

The destructor only deletes the pointers if count reaches zero.

Definition at line 193 of file spmatrix_char.hpp.

References ccgsl_pointer, and count.

◆ spmatrix_char() [7/7]

gsl::spmatrix_char::spmatrix_char ( spmatrix_char && v )

inline

Move constructor.

Parameters

v	The spmatrix_char to move.

Definition at line 233 of file spmatrix_char.hpp.

References count.

Member Function Documentation

◆ add() [1/2]

static int gsl::spmatrix_char::add	(	spmatrix_char &	c,
		spmatrix_char const &	a,
		spmatrix_char const &	b
	)

inlinestatic

C++ version of gsl_spmatrix_char_add().

Parameters

c	An spmatrix_char object
a	An spmatrix_char object
b	An spmatrix_char object

Returns: Error code on failure

Definition at line 612 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a(), gsl::sf::mathieu::b(), and get().

◆ add() [2/2]

static spmatrix_char gsl::spmatrix_char::add	(	spmatrix_char const &	a,
		spmatrix_char const &	b
	)

inlinestatic

C++ version of gsl_spmatrix_char_add().

Parameters

a	An spmatrix_char object
b	An spmatrix_char object

Returns: The sum of a and b

Definition at line 620 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a(), and gsl::sf::mathieu::b().

◆ add_to_dense()

static int gsl::spmatrix_char::add_to_dense	(	gsl::matrix_char &	a,
		spmatrix_char const &	b
	)

inlinestatic

C++ version of gsl_spmatrix_add_to_dense().

Parameters

a	A gsl::matrix_char (return value is sum)
b	A gsl::spmatrix_char

Returns: Error code on failure

Definition at line 632 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a(), and gsl::sf::mathieu::b().

◆ ccs() [1/2]

spmatrix_char gsl::spmatrix_char::ccs ( ) const

inline

C++ version of gsl_spmatrix_char_ccs().

Returns: A compressed matrix_char

Definition at line 357 of file spmatrix_char.hpp.

References get().

◆ ccs() [2/2]

static spmatrix_char gsl::spmatrix_char::ccs ( spmatrix_char const & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_ccs().

Parameters

spMatrix An spmatrix_char object

Returns: A compressed matrix_char

Definition at line 554 of file spmatrix_char.hpp.

References get().

◆ clone()

spmatrix_char gsl::spmatrix_char::clone ( ) const

inline

The clone function.

Use this if you want a copy of the spmatrix_char that does not share the underlying data.

Returns: a new copy of this.

Definition at line 182 of file spmatrix_char.hpp.

References get(), size1(), and size2().

◆ compcol() [1/2]

spmatrix_char gsl::spmatrix_char::compcol ( ) const

inline

C++ version of gsl_spmatrix_char_compcol().

Returns: A compressed matrix_char

Definition at line 350 of file spmatrix_char.hpp.

References get().

◆ compcol() [2/2]

static spmatrix_char gsl::spmatrix_char::compcol ( spmatrix_char const & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_compcol().

Parameters

spMatrix An spmatrix_char object

Returns: A compressed matrix_char

Definition at line 546 of file spmatrix_char.hpp.

References get().

◆ compress() [1/2]

spmatrix_char gsl::spmatrix_char::compress ( int const sptype ) const

inline

C++ version of gsl_spmatrix_char_compress().

Parameters

sptype One of gsl::spmatrix_char::COO, gsl::spmatrix_char::CSC or gsl::spmatrix_char::CSR

Returns: The compressed matrix_char

Definition at line 343 of file spmatrix_char.hpp.

References get(), and sptype().

◆ compress() [2/2]

static spmatrix_char gsl::spmatrix_char::compress	(	spmatrix_char const &	spMatrix,
		int const	sptype
	)

inlinestatic

C++ version of gsl_spmatrix_char_compress().

Parameters

spMatrix	An spmatrix_char object
sptype	One of gsl::spmatrix_char::COO, gsl::spmatrix_char::CSC or gsl::spmatrix_char::CSR

Returns: The compressed matrix_char

Definition at line 538 of file spmatrix_char.hpp.

References get(), and sptype().

◆ crs() [1/2]

spmatrix_char gsl::spmatrix_char::crs ( ) const

inline

C++ version of gsl_spmatrix_char_crs().

Returns: A compressed matrix_char

Definition at line 364 of file spmatrix_char.hpp.

References get().

◆ crs() [2/2]

static spmatrix_char gsl::spmatrix_char::crs ( spmatrix_char const & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_crs().

Parameters

spMatrix An spmatrix_char object

Returns: A compressed matrix_char

Definition at line 562 of file spmatrix_char.hpp.

References get().

◆ csc() [1/2]

spmatrix_char gsl::spmatrix_char::csc ( ) const

inline

C++ version of gsl_spmatrix_char_csc().

Returns: a sparse matrix_char in compressed sparse column format from this which must be in COO format

Definition at line 323 of file spmatrix_char.hpp.

References get(), size1(), and size2().

◆ csc() [2/2]

static spmatrix_char gsl::spmatrix_char::csc ( spmatrix_char const & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_csc().

Sets dest to a sparse matrix_char in compressed sparse column format from the input sparse matrix_char src, which must be in COO format

Parameters

spMatrix An spmatrix_char object

Returns: Error code on failure

Definition at line 518 of file spmatrix_char.hpp.

References get(), size1(), and size2().

◆ csr() [1/2]

spmatrix_char gsl::spmatrix_char::csr ( ) const

inline

C++ version of gsl_spmatrix_char_csr().

Returns: a sparse matrix_char in compressed sparse row format from this which must be in COO format

Definition at line 333 of file spmatrix_char.hpp.

References get(), size1(), and size2().

◆ csr() [2/2]

static spmatrix_char gsl::spmatrix_char::csr ( spmatrix_char const & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_csr().

Sets dest to a sparse matrix_char in compressed sparse row format from the input sparse matrix_char src, which must be in COO format

Parameters

spMatrix An spmatrix_char object

Returns: Error code on failure

Definition at line 528 of file spmatrix_char.hpp.

References get(), size1(), and size2().

◆ d2sp()

static int gsl::spmatrix_char::d2sp	(	gsl::spmatrix_char &	S,
		gsl::matrix_char const &	A
	)

inlinestatic

C++ version of gsl_spmatrix_char_d2sp().

Parameters

S	A gsl::spmatrix_char (return value)
A	A gsl::matrix_char

Returns: Error code on failure

Definition at line 664 of file spmatrix_char.hpp.

References gsl::matrix_char::get(), and get().

◆ data() [1/2]

char * gsl::spmatrix_char::data ( )

inline

Give access to the data block.

Returns: The data block.

Definition at line 273 of file spmatrix_char.hpp.

References ccgsl_pointer.

◆ data() [2/2]

char const * gsl::spmatrix_char::data ( ) const

inline

Give access to the data block.

Returns: The data block.

Definition at line 280 of file spmatrix_char.hpp.

References ccgsl_pointer.

◆ dense_add()

static int gsl::spmatrix_char::dense_add	(	gsl::matrix_char &	a,
		spmatrix_char const &	b
	)

inlinestatic

C++ version of gsl_spmatrix_dense_add().

Parameters

a	A gsl::matrix_char (return value is sum)
b	A gsl::spmatrix_char

Returns: Error code on failure

Definition at line 641 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a(), and gsl::sf::mathieu::b().

◆ dense_sub()

static int gsl::spmatrix_char::dense_sub	(	gsl::matrix_char &	a,
		spmatrix_char const &	b
	)

inlinestatic

C++ version of gsl_spmatrix_dense_sub().

Parameters

a	A gsl::matrix_char (return value is difference)
b	A gsl::spmatrix_char

Returns: Error code on failure

Definition at line 649 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a(), and gsl::sf::mathieu::b().

◆ equal() [1/2]

static int gsl::spmatrix_char::equal	(	spmatrix_char const &	a,
		spmatrix_char const &	b
	)

inlinestatic

C++ version of gsl_spmatrix_char_equal().

Parameters

a	An spmatrix_char
b	An spmatrix_char

Returns: 1 or 0 according as a and b are equal or not

Definition at line 680 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a(), and gsl::sf::mathieu::b().

◆ equal() [2/2]

int gsl::spmatrix_char::equal ( spmatrix_char const & b ) const

inline

C++ version of gsl_spmatrix_char_equal().

Parameters

b	An spmatrix_char

Returns: 1 or 0 according as a and b are equal or not

Definition at line 463 of file spmatrix_char.hpp.

References gsl::sf::mathieu::b(), and get().

◆ fprintf() [1/2]

int gsl::spmatrix_char::fprintf	(	FILE *	stream,
		char const *	format
	)		const

inline

C++ version of gsl_spmatrix_char_fprintf().

Parameters

stream	A file stream
format	One of the g, e or f formats for floating point numbers

Returns: Error code on failure

Definition at line 379 of file spmatrix_char.hpp.

References get().

◆ fprintf() [2/2]

static int gsl::spmatrix_char::fprintf	(	FILE *	stream,
		spmatrix_char const &	spMatrix,
		char const *	format
	)

inlinestatic

C++ version of gsl_spmatrix_char_fprintf().

Parameters

stream	A file stream
spMatrix	An spmatrix_char object
format	One of the g, e or f formats for floating point numbers

Returns: Error code on failure

Definition at line 580 of file spmatrix_char.hpp.

References get().

◆ fread() [1/2]

int gsl::spmatrix_char::fread ( FILE * stream )

inline

C++ version of gsl_spmatrix_char_fread().

Parameters

stream A file stream

Returns: Error code on failure

Definition at line 393 of file spmatrix_char.hpp.

References get().

◆ fread() [2/2]

static int gsl::spmatrix_char::fread	(	FILE *	stream,
		spmatrix_char &	spMatrix
	)

inlinestatic

C++ version of gsl_spmatrix_char_fread().

Parameters

stream	A file stream
spMatrix	An spmatrix_char object

Returns: Error code on failure

Definition at line 603 of file spmatrix_char.hpp.

References get().

◆ fscanf()

static spmatrix_char gsl::spmatrix_char::fscanf ( FILE * stream )

inlinestatic

C++ version of gsl_spmatrix_char_fscanf().

Parameters

stream A file stream

Returns: The spMatrix read from a file stream

Definition at line 587 of file spmatrix_char.hpp.

◆ fwrite() [1/2]

int gsl::spmatrix_char::fwrite ( FILE * stream ) const

inline

C++ version of gsl_spmatrix_char_fwrite().

Parameters

stream A file stream

Returns: Error code on failure

Definition at line 386 of file spmatrix_char.hpp.

References get().

◆ fwrite() [2/2]

static int gsl::spmatrix_char::fwrite	(	FILE *	stream,
		spmatrix_char &	spMatrix
	)

inlinestatic

C++ version of gsl_spmatrix_char_fwrite().

Parameters

stream	A file stream
spMatrix	An spmatrix_char object

Returns: Error code on failure

Definition at line 595 of file spmatrix_char.hpp.

References get().

◆ get() [1/3]

gsl_spmatrix_char * gsl::spmatrix_char::get ( )

inline

Get the gsl_spmatrix_char.

Returns: the gsl_spmatrix_char

Definition at line 717 of file spmatrix_char.hpp.

References ccgsl_pointer.

Referenced by ccs(), clone(), compcol(), compress(), crs(), csc(), csr(), equal(), fprintf(), fread(), fwrite(), get(), memcpy(), min_index(), minmax(), nnz(), ptr(), realloc(), scale(), scale_columns(), scale_rows(), set(), set_zero(), transpose(), transpose2(), tree_rebuild(), and type().

◆ get() [2/3]

gsl_spmatrix_char const * gsl::spmatrix_char::get ( ) const

inline

Get the gsl_spmatrix_char.

Returns: the gsl_spmatrix_char

Definition at line 722 of file spmatrix_char.hpp.

References ccgsl_pointer.

◆ get() [3/3]

char gsl::spmatrix_char::get	(	size_t const	i,
		size_t const	j
	)		const

inline

C++ version of gsl_spmatrix_char_get().

Parameters

i	Row index
j	Column index

Returns: Value in sparse matrix_char

Definition at line 401 of file spmatrix_char.hpp.

References get().

Referenced by add(), ccs(), clone(), compcol(), compress(), crs(), csc(), csr(), d2sp(), fprintf(), fread(), fwrite(), memcpy(), nnz(), realloc(), set_zero(), sp2d(), transpose_memcpy(), tree_rebuild(), and type().

◆ memcpy() [1/2]

int gsl::spmatrix_char::memcpy ( spmatrix_char & dest ) const

inline

C++ version of gsl_spmatrix_char_memcpy().

Parameters

dest	The destination spmatrix_char

Returns: Error code on failure

Definition at line 372 of file spmatrix_char.hpp.

References get().

◆ memcpy() [2/2]

static int gsl::spmatrix_char::memcpy	(	spmatrix_char &	dest,
		spmatrix_char const &	src
	)

inlinestatic

C++ version of gsl_spmatrix_char_memcpy().

Parameters

dest	The destination spmatrix_char
src	The source spmatrix_char

Returns: Error code on failure

Definition at line 571 of file spmatrix_char.hpp.

References get().

◆ min_index()

int gsl::spmatrix_char::min_index	(	size_t &	imin_out,
		size_t &	jmin_out
	)		const

inline

C++ version of gsl_spmatrix_char_min_index().

Parameters

imin_out	The row index of the minimum nonzero element (by reference)
jmin_out	The column index of the minimum nonzero element (by reference)

Returns: Error code on failure

Definition at line 435 of file spmatrix_char.hpp.

References get().

◆ minmax()

int gsl::spmatrix_char::minmax	(	char &	min_out,
		char &	max_out
	)		const

inline

C++ version of gsl_spmatrix_char_minmax().

Parameters

min_out	The minimum element (by reference)
max_out	The maximum element (by reference)

Returns: Error code on failure

Definition at line 427 of file spmatrix_char.hpp.

References get().

◆ nnz() [1/2]

size_t gsl::spmatrix_char::nnz ( ) const

inline

C++ version of gsl_spmatrix_char_nnz().

Returns: The number of nonzero elements of this

Definition at line 302 of file spmatrix_char.hpp.

References get().

◆ nnz() [2/2]

static size_t gsl::spmatrix_char::nnz ( spmatrix_char const & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_nnz().

Parameters

spMatrix An spmatrix_char object

Returns: The number of nonzero elements of spMatrix

Definition at line 489 of file spmatrix_char.hpp.

References get().

◆ norm1()

static char gsl::spmatrix_char::norm1 ( gsl::spmatrix_char const & a )

inlinestatic

C++ version of gsl_spmatrix_char_norm1().

Parameters

a	A gsl::spmatrix_char

Returns: The 1-norm

Definition at line 656 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a().

◆ nzmax()

size_t gsl::spmatrix_char::nzmax ( ) const

inline

The maximum number of nonzero elements.

Returns: the maximum number of nonzero elements

Definition at line 263 of file spmatrix_char.hpp.

References ccgsl_pointer.

Referenced by realloc(), and spmatrix_char().

◆ operator bool()

gsl::spmatrix_char::operator bool ( ) const

inlineexplicit

Allow conversion to bool.

Returns: true or false according as this contains a pointer to a gsl_spmatrix_char

Definition at line 742 of file spmatrix_char.hpp.

References ccgsl_pointer.

◆ operator=() [1/2]

spmatrix_char & gsl::spmatrix_char::operator= ( spmatrix_char && v )

inline

Move operator.

Parameters

v	The spmatrix_char to move.

Returns: A reference to this.

Definition at line 242 of file spmatrix_char.hpp.

References spmatrix_char().

◆ operator=() [2/2]

spmatrix_char & gsl::spmatrix_char::operator= ( spmatrix_char const & v )

inline

The assignment operator.

This makes a shared copy.

Parameters

v	The matrix_char to copy

Definition at line 162 of file spmatrix_char.hpp.

References ccgsl_pointer, and count.

◆ ptr()

char * gsl::spmatrix_char::ptr	(	size_t const	i,
		size_t const	j
	)		const

inline

C++ version of gsl_spmatrix_char_ptr().

Parameters

i	Row index
j	Column index

Returns: Error code on failure

Definition at line 418 of file spmatrix_char.hpp.

References get().

◆ realloc() [1/2]

int gsl::spmatrix_char::realloc ( size_t const nzmax )

inline

C++ version of gsl_spmatrix_char_realloc().

This is not usually used.

Parameters

nzmax The maximum number of nonzero elements

Returns: Error code on failure

Definition at line 297 of file spmatrix_char.hpp.

References get(), and nzmax().

◆ realloc() [2/2]

static int gsl::spmatrix_char::realloc	(	size_t const	nzmax,
		gsl::spmatrix_char &	spMatrix
	)

inlinestatic

C++ version of gsl_spmatrix_char_realloc(): matches a function in gsl that is intended for internal use.

Parameters

nzmax	The maximum number of nonzero elements
spMatrix	An spmatrix_char object

Returns: Error code on failure

Definition at line 482 of file spmatrix_char.hpp.

References get(), and nzmax().

◆ reset()

void gsl::spmatrix_char::reset ( )

inline

Stop sharing ownership of the shared pointer.

Definition at line 227 of file spmatrix_char.hpp.

References spmatrix_char().

◆ scale()

int gsl::spmatrix_char::scale ( char const x )

inline

C++ version of gsl_spmatrix_char_scale().

Parameters

x	A scaling factor

Returns: Error code on failure

Definition at line 443 of file spmatrix_char.hpp.

References get().

◆ scale_columns()

int gsl::spmatrix_char::scale_columns ( gsl::vector_char const & x )

inline

C++ version of gsl_spmatrix_char_scale_columns().

Parameters

x	A scaling gsl::vector_char

Returns: Error code on failure

Definition at line 449 of file spmatrix_char.hpp.

References get(), and gsl::vector_char::get().

◆ scale_rows()

int gsl::spmatrix_char::scale_rows ( gsl::vector_char const & x )

inline

C++ version of gsl_spmatrix_char_scale_rows().

Parameters

x	A scaling gsl::vector_char

Returns: Error code on failure

Definition at line 456 of file spmatrix_char.hpp.

References get(), and gsl::vector_char::get().

◆ set()

int gsl::spmatrix_char::set	(	size_t const	i,
		size_t const	j,
		char const	x
	)

inline

C++ version of gsl_spmatrix_char_set().

Parameters

i	Row index
j	Column value
x	New matrix_char entry

Returns: Error code on failure

Definition at line 410 of file spmatrix_char.hpp.

References get().

Referenced by spmatrix_char().

◆ set_zero() [1/2]

int gsl::spmatrix_char::set_zero ( )

inline

C++ version of gsl_spmatrix_char_set_zero().

Reinitialise spmatrix_char to zeros.

Returns: Error code on failure

Definition at line 312 of file spmatrix_char.hpp.

References get().

◆ set_zero() [2/2]

static int gsl::spmatrix_char::set_zero ( spmatrix_char & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_set_zero().

Reinitialise spmatrix_char to zeros.

Parameters

spMatrix An spmatrix_char object

Returns: Error code on failure

Definition at line 503 of file spmatrix_char.hpp.

References get().

◆ size1()

size_t gsl::spmatrix_char::size1 ( ) const

inline

The number of rows of the matrix_char.

Returns: The number of rows of the matrix_char

Definition at line 253 of file spmatrix_char.hpp.

References ccgsl_pointer.

Referenced by clone(), csc(), and csr().

◆ size2()

size_t gsl::spmatrix_char::size2 ( ) const

inline

The number of columns of the matrix_char.

Returns: The number of columns of the matrix_char

Definition at line 258 of file spmatrix_char.hpp.

References ccgsl_pointer.

Referenced by clone(), csc(), and csr().

◆ sp2d()

static int gsl::spmatrix_char::sp2d	(	gsl::matrix_char &	A,
		spmatrix_char const &	S
	)

inlinestatic

C++ version of gsl_spmatrix_char_sp2d().

Parameters

A	A gsl::matrix_char (return value)
S	A gsl::spmatrix_char

Returns: Error code on failure

Definition at line 672 of file spmatrix_char.hpp.

References gsl::matrix_char::get(), and get().

◆ sptype()

int gsl::spmatrix_char::sptype ( ) const

inline

The type of the spmatrix_char.

Returns: the type of the spmatrix_char

Definition at line 268 of file spmatrix_char.hpp.

References ccgsl_pointer.

Referenced by compress(), and spmatrix_char().

◆ swap()

void gsl::spmatrix_char::swap ( spmatrix_char & m )

inline

Swap two spmatrix_char objects.

This works even if the spmatrix_char objects have different sizes because it swaps pointers.

Parameters

m	The spmatrix_char to swap with `this`.

Definition at line 288 of file spmatrix_char.hpp.

References ccgsl_pointer, and count.

◆ transpose() [1/2]

int gsl::spmatrix_char::transpose ( )

inline

C++ version of gsl_spmatrix_char_transpose().

Returns: Error code on failure

Definition at line 468 of file spmatrix_char.hpp.

References get().

◆ transpose() [2/2]

static int gsl::spmatrix_char::transpose ( spmatrix_char & a )

inlinestatic

C++ version of gsl_spmatrix_char_transpose().

Parameters

a	An spmatrix_char

Returns: Error code on failure

Definition at line 687 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a().

◆ transpose2() [1/2]

int gsl::spmatrix_char::transpose2 ( )

inline

C++ version of gsl_spmatrix_char_transpose2().

Returns: Error code on failure

Definition at line 473 of file spmatrix_char.hpp.

References get().

◆ transpose2() [2/2]

static int gsl::spmatrix_char::transpose2 ( spmatrix_char & a )

inlinestatic

C++ version of gsl_spmatrix_char_transpose2().

Parameters

a	An spmatrix_char

Returns: Error code on failure

Definition at line 693 of file spmatrix_char.hpp.

References gsl::sf::mathieu::a().

◆ transpose_memcpy()

static int gsl::spmatrix_char::transpose_memcpy	(	spmatrix_char &	dest,
		spmatrix_char const &	src
	)

inlinestatic

C++ version of gsl_spmatrix_char_transpose_memcpy().

Parameters

dest	An spmatrix_char (return)
src	An spmatrix_char

Returns: Error code on failure

Definition at line 700 of file spmatrix_char.hpp.

References get().

◆ tree_rebuild() [1/2]

int gsl::spmatrix_char::tree_rebuild ( )

inline

C++ version of gsl_spmatrix_char_tree_rebuild().

Returns: Error code on failure

Definition at line 317 of file spmatrix_char.hpp.

References get().

◆ tree_rebuild() [2/2]

static int gsl::spmatrix_char::tree_rebuild ( spmatrix_char & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_tree_rebuild().

Parameters

spMatrix An spmatrix_char object

Returns: Error code on failure

Definition at line 510 of file spmatrix_char.hpp.

References get().

◆ type() [1/2]

char const * gsl::spmatrix_char::type ( ) const

inline

C++ version of gsl_spmatrix_char_type().

Returns: A string describing the sparse matrix_char storage format

Definition at line 307 of file spmatrix_char.hpp.

References get().

◆ type() [2/2]

static char const * gsl::spmatrix_char::type ( spmatrix_char const & spMatrix )

inlinestatic

C++ version of gsl_spmatrix_char_type().

Parameters

spMatrix An spmatrix_char object

Returns: A string describing the sparse matrix_char storage format

Definition at line 496 of file spmatrix_char.hpp.

References get().

◆ unique()

bool gsl::spmatrix_char::unique ( ) const

inline

Find if this is the only object sharing the gsl_spmatrix_char.

Returns: true or falses according as this is the only spmatrix_char object sharing the gsl_spmatrix_char

Definition at line 728 of file spmatrix_char.hpp.

References count.

◆ use_count()

size_t gsl::spmatrix_char::use_count ( ) const

inline

Find how many spmatrix_char objects share this pointer.

Returns: the number of spmatrix_char objects that share this pointer

Definition at line 733 of file spmatrix_char.hpp.

References count.

◆ wrap_gsl_spmatrix_char_without_ownership()

void gsl::spmatrix_char::wrap_gsl_spmatrix_char_without_ownership ( gsl_spmatrix_char * v )

inline

This function is intended mainly for internal use.

It allows this to point to a gsl_spmatrix_char without the possibility deleting it when this is no longer in scope. It is the responsibility of the programmer to delete v. The function is used internally for converting a function that takes a gsl::spmatrix_char* argument to one that takes a gsl_spmatrix_char* argument.

Parameters

v	The gsl_spmatrix_char

Definition at line 212 of file spmatrix_char.hpp.

References ccgsl_pointer, and count.

Member Data Documentation

◆ ccgsl_pointer

gsl_spmatrix_char* gsl::spmatrix_char::ccgsl_pointer

private

The shared pointer.

Definition at line 706 of file spmatrix_char.hpp.

Referenced by data(), get(), nzmax(), operator bool(), operator=(), size1(), size2(), spmatrix_char(), sptype(), swap(), wrap_gsl_spmatrix_char_without_ownership(), and ~spmatrix_char().

◆ count

size_t* gsl::spmatrix_char::count

private

The shared reference count.

Definition at line 710 of file spmatrix_char.hpp.

Referenced by operator=(), spmatrix_char(), swap(), unique(), use_count(), wrap_gsl_spmatrix_char_without_ownership(), and ~spmatrix_char().

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

spmatrix_char.hpp

Public Types

Public Member Functions

Static Public Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ spmatrix_char() [1/7]

◆ spmatrix_char() [2/7]

◆ spmatrix_char() [3/7]

◆ spmatrix_char() [4/7]

◆ spmatrix_char() [5/7]

◆ spmatrix_char() [6/7]

◆ ~spmatrix_char()

◆ spmatrix_char() [7/7]

Member Function Documentation

◆ add() [1/2]

◆ add() [2/2]

◆ add_to_dense()

◆ ccs() [1/2]

◆ ccs() [2/2]

◆ clone()

◆ compcol() [1/2]

◆ compcol() [2/2]

◆ compress() [1/2]

◆ compress() [2/2]

◆ crs() [1/2]

◆ crs() [2/2]

◆ csc() [1/2]

◆ csc() [2/2]

◆ csr() [1/2]

◆ csr() [2/2]

◆ d2sp()

◆ data() [1/2]

◆ data() [2/2]

◆ dense_add()

◆ dense_sub()

◆ equal() [1/2]

◆ equal() [2/2]

◆ fprintf() [1/2]

◆ fprintf() [2/2]

◆ fread() [1/2]

◆ fread() [2/2]

◆ fscanf()

◆ fwrite() [1/2]

◆ fwrite() [2/2]

◆ get() [1/3]

◆ get() [2/3]

◆ get() [3/3]

◆ memcpy() [1/2]

◆ memcpy() [2/2]

◆ min_index()

◆ minmax()

◆ nnz() [1/2]

◆ nnz() [2/2]

◆ norm1()

◆ nzmax()

◆ operator bool()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ ptr()

◆ realloc() [1/2]

◆ realloc() [2/2]

◆ reset()

◆ scale()

◆ scale_columns()

◆ scale_rows()

◆ set()

◆ set_zero() [1/2]

◆ set_zero() [2/2]

◆ size1()

◆ size2()

◆ sp2d()

◆ sptype()

◆ swap()

◆ transpose() [1/2]

◆ transpose() [2/2]

◆ transpose2() [1/2]

◆ transpose2() [2/2]