ms_linker_site_vector Class Reference

A vector of linker sites. More...

#include <ms_linker_site_vector.hpp>

Public Member Functions
	ms_linker_site_vector ()
	Create an empty linker site vector.
	ms_linker_site_vector (const ms_linker_site_vector &src)
	Copying constructor.
	ms_linker_site_vector (const std::list< ms_linker_site > &v, const int alphaVarModsLen, const int betaVarModsLen)
	Create a linker site vector from an STL list.
	ms_linker_site_vector (const std::vector< ms_linker_site > &v, const int alphaVarModsLen, const int betaVarModsLen)
	Create a linker site vector from an STL vector.
	~ms_linker_site_vector ()
	Destructor.
void	append (const ms_linker_site_vector &src)
	Appends all content from another instance of the class.
void	clear ()
	Clear the vector.
bool	containsVarModIdx (int idx) const
	Return true if the vector contains a link with the given variable mod index.
void	copyFrom (const ms_linker_site_vector *src)
	Copies all content from another instance of the class.
bool	empty () const
	Boolean test: is the vector empty?
ms_linker_site	get (int idx) const
	Return the linker site at the given index.
int	getAlphaVarModsStrLength () const
	Return the alpha peptide sequence length.
int	getBetaVarModsStrLength () const
	Return the beta peptide sequence length.
int	getVarModIdxOfLinkedSite (const ms_peptide::PSM psmComponent, const int i) const
	Return the variable mod index if the PSM component has a link at position i.
ms_linker_site_vector &	operator= (const ms_linker_site_vector &right)
	C++ assignment operator.
ms_linker_site	pop ()
	Pop a value from the end of the vector.
void	push (const ms_linker_site &linkerSite)
	Push a new linker site at the end of the vector.
void	set (int idx, const ms_linker_site &linkerSite)
	Set the value at the given index.
int	size () const
	Return the size of the container.
void	swap (ms_linker_site_vector &right)
	Swap the contents with another linker site vector.
const std::vector< ms_linker_site > &	toVector () const
	C++ conversion to std::vector.

Detailed Description

A vector of linker sites.

ms_linker_site_vector is a wrapper around the C++ vector class std::vector, specialised to contain ms_linker_site objects. The ms_peptide class returns such vectors.

The interface to this class follows that of vectori and vectorString, as described in Using STL vector classes vectori, vectord and VectorString in Perl, Java, Python and C#.

Constructor & Destructor Documentation

ms_linker_site_vector() [1/2]

ms_linker_site_vector	(	const std::vector< ms_linker_site > &	v,
		const int	alphaVarModsLen,
		const int	betaVarModsLen
	)

Create a linker site vector from an STL vector.

Note

This constructor can only be used from C++.

The alpha and beta variable mods string lengths are not optional, but one or both can be set to zero. See getVarModIdxOfLinkedSite().

Parameters

v	STL vector to initialise with.
alphaVarModsLen	length of the alpha peptide variable mods string.
betaVarModsLen	length of the beta peptide variable mods string.

ms_linker_site_vector() [2/2]

ms_linker_site_vector	(	const std::list< ms_linker_site > &	v,
		const int	alphaVarModsLen,
		const int	betaVarModsLen
	)

Create a linker site vector from an STL list.

Note

This constructor can only be used from C++.

The alpha and beta variable mods string lengths are not optional, but one or both can be set to zero. See getVarModIdxOfLinkedSite().

Parameters

v	STL list to initialise with.
alphaVarModsLen	length of the alpha peptide variable mods string.
betaVarModsLen	length of the beta peptide variable mods string.

Member Function Documentation

append()

void append

(

const ms_linker_site_vector &

src

)

Appends all content from another instance of the class.

This method does not change getAlphaVarModsStrLength() or getBetaVarModsStrLength().

Parameters

src	is another ms_linker_site_vector to append the sites from.

clear()

void clear

(

)

Clear the vector.

After clear, the vector will be empty. Alpha and beta variable mods string lengths are set to zero.

containsVarModIdx()

bool containsVarModIdx

(

int

idx

)

const

Return true if the vector contains a link with the given variable mod index.

Parameters

idx	Variable mod index.

Returns

True if any linker object uses idx at either end of the link.

empty()

bool empty

(

)

const

Boolean test: is the vector empty?

Returns

True if the vector is empty (has size 0); false otherwise.

get()

ms_linker_site get

(

int

idx

)

const

Return the linker site at the given index.

Note that idx must be within the 0-indexed range. Otherwise the method will throw an exception.

Parameters

idx	The element index, 0..size()-1.

Returns

The element at the corresponding index.

getAlphaVarModsStrLength()

int getAlphaVarModsStrLength

(

)

const

Return the alpha peptide sequence length.

Returns

Length of the alpha variable mods string, or 0 if not set.

getBetaVarModsStrLength()

int getBetaVarModsStrLength

(

)

const

Return the beta peptide sequence length.

Returns

Length of the beta variablem mods string, or 0 if not set.

getVarModIdxOfLinkedSite()

int getVarModIdxOfLinkedSite	(	const ms_peptide::PSM	psmComponent,
		const int	i
	)		const

Return the variable mod index if the PSM component has a link at position i.

There are two use cases.

If psmComponent is ms_peptide::PSM_CROSSLINK_ALPHA or ms_peptide::PSM_CROSSLINK_BETA, the position i indexes the alpha or the beta variable mods string returned by ms_peptide::getVarModsStr(psmComponent). This method returns a non-zero variable mod number if there is a link in the given psmComponent at position i.

If psmComponent is ms_peptide::PSM_COMPLETE, the position i indexes the concatenated variable mods string returned by ms_peptide::getVarModsStr(PSM_COMPLETE). A simple calculation is done to determine whether i is a position in the alpha or the beta peptide:

• If (0 <= i and i < alphaVarModsLen), then set pos = i and psmComponent = ms_peptide::PSM_CROSSLINK_ALPHA.
• If (alphaLen <= i and i < alphaVarModsLen + betaVarModsLen), then set pos = (i - alphaVarModsLen) and psmComponent = ms_peptide::PSM_CROSSLINK_BETA.

One or both of alpha or beta variable mods string lengths can be zero.

Parameters

psmComponent	One of ms_peptide::PSM.
i	Position within the variable mods string.

Returns

Variable mod index if the there is a link at position i. If there is no link, returns 0.

pop()

ms_linker_site pop

(

)

Pop a value from the end of the vector.

Note that the vector must be nonempty (it must contain at least one element). If it doesn't, the method throws an exception.

Returns

The value popped from the end of the vector.

push()

void push

(

const ms_linker_site &

linkerSite

)

Push a new linker site at the end of the vector.

Parameters

linkerSite

Linker site to append to the vector.

set()

void set	(	int	idx,
		const ms_linker_site &	linkerSite
	)

Set the value at the given index.

Note that idx must be within the 0-indexed range. Otherwise the method will throw an exception. If you need to extend the vector, use push().

Parameters

idx	The element index, 0..size()-1.
linkerSite	The new value to be set at that index.

size()

int size

(

)

const

Return the size of the container.

Returns

The number of elements in the vector, or 0 if the vector is empty.

swap()

void swap

(

ms_linker_site_vector &

src

)

Swap the contents with another linker site vector.

After this method returns, the data of src is stored inside this object, and src stores the old contents of this object.

This method swaps getAlphaVarModsStrLength() and getBetaVarModsStrLength() with src.

Parameters

src	Linker site vector to swap contents with.

toVector()

const std::vector< ms_linker_site > & toVector

(

)

const

C++ conversion to std::vector.

Note

This method can only be used from C++.

Returns

A copy of the linker site vector as an STL vector.

---

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

• ms_linker_site_vector.hpp
• ms_linker_site.cpp