Matrix Science Mascot Parser toolkit
 
Loading...
Searching...
No Matches
ms_crosslinking_linkers Class Reference

Linkers element in crosslinking.xml More...

#include <ms_crosslinking_linkers.hpp>

Inherits ms_xml_IValidatable.

Public Member Functions

 ms_crosslinking_linkers ()
 Default constructor.
 
 ms_crosslinking_linkers (const ms_crosslinking_linkers &src)
 Copying constructor.
 
virtual ~ms_crosslinking_linkers ()
 Destructor.
 
void appendLinker (const ms_crosslinking_linker *item)
 Adds a new linker code at the end of the list.
 
void clearLinkers ()
 Deletes all linker codes from the list.
 
void copyFrom (const ms_crosslinking_linkers *right)
 Copies all content from another instance.
 
void defaultValues ()
 Call this member if you want to start again.
 
bool deleteLinkerByNumber (const int idx)
 Remove a linker code from the list in memory by its index.
 
const ms_crosslinking_linkergetLinkerByNumber (const int idx) const
 Returns a linker code object by its number.
 
std::string getLinkerSchemaType () const
 Obtain a symbolic name for the linker element schema type.
 
int getNumberOfLinkers () const
 Returns the number of linker.
 
virtual std::string getSchemaType () const
 Returns name of the schema type that can be used to validate this element.
 
ms_crosslinking_linkersoperator= (const ms_crosslinking_linkers &right)
 C++ style assignment operator.
 
bool updateLinkerByNumber (const int idx, const ms_crosslinking_linker *linker)
 Update the information for a specific linker code refering to it by its index.
 
virtual std::string validateDeep (const ms_xml_schema *pSchemaFileObj) const
 Performs validation of all child elements in addition to 'shallow' validation.
 
virtual std::string validateShallow (const ms_xml_schema *pSchemaFileObj) const
 Performs simple validation of the top-level elements only.
 

Detailed Description

Linkers element in crosslinking.xml

The linkers element groups together specificities of a single linker.

In Mascot 2.7, the restrictions are:

  • At most one linkers element
  • The linkers group can contain multiple specificities of a single linker

For example, it is possible to specify Xlink:DSS (K) and Xlink:DSS (Protein N-term) for searching, as it is a single linker with two specificities. It is not possible to select two different linkers, like Xlink:DSS and Xlink:DSSO.

Constructor & Destructor Documentation

◆ ms_crosslinking_linkers() [1/2]

Default constructor.

Assigns reasonable default values to all internal members.

◆ ms_crosslinking_linkers() [2/2]

Copying constructor.

Parameters
srcanother instance of this class to copy the content from.

Member Function Documentation

◆ appendLinker()

void appendLinker ( const ms_crosslinking_linker item)

Adds a new linker code at the end of the list.

Creates a new linker code object, copies all content from the object supplied as a parameter and adds it at the end of the methods list.

Parameters
iteman instance of a linker object to copy content from.

◆ copyFrom()

void copyFrom ( const ms_crosslinking_linkers right)

Copies all content from another instance.

Parameters
rightanother instance of this class to copy the content from.

◆ defaultValues()

void defaultValues ( )

Call this member if you want to start again.

All internal values are reset to their defaults, as if the object had been freshly created with the default constructor.

◆ deleteLinkerByNumber()

bool deleteLinkerByNumber ( const int  idx)

Remove a linker code from the list in memory by its index.

Parameters
idxnumber of the linker code for deletion from 0 to (getNumberOfLinkers() - 1).
Returns
TRUE if the linker code has been found and successfully deleted and FALSE otherwise.

◆ getLinkerByNumber()

const ms_crosslinking_linker * getLinkerByNumber ( const int  idx) const

Returns a linker code object by its number.

Parameters
idxnumber of the linker code from 0 to (getNumberOfLinkers() - 1).
Returns
a read-only pointer to a linker object. See Maintaining object references: two rules of thumb.

◆ getLinkerSchemaType()

std::string getLinkerSchemaType ( ) const

Obtain a symbolic name for the linker element schema type.

The obtained type name can be used to get a corresponding type description object from ms_xml_schema.

Returns
symbolic type name for the element.

◆ getNumberOfLinkers()

int getNumberOfLinkers ( ) const

Returns the number of linker.

Returns
total number of monolink codes.

◆ getSchemaType()

std::string getSchemaType ( ) const
virtual

Returns name of the schema type that can be used to validate this element.

Additional information about the current object can be retrieved from the associated XML schema file. Every element in an XML document is defined with a named type, which you can use to find out what kind of limits (numerical or otherwise) are defined for values of that type.

See also
validateShallow(), validateDeep()
Returns
a symbolic fully qualified type name (for example, "umod:nameType")

◆ operator=()

ms_crosslinking_linkers & operator= ( const ms_crosslinking_linkers right)

C++ style assignment operator.

Parameters
rightanother instance of this class to copy the content from.
Returns
reference to the current object

◆ updateLinkerByNumber()

bool updateLinkerByNumber ( const int  idx,
const ms_crosslinking_linker linker 
)

Update the information for a specific linker code refering to it by its index.

Parameters
idxnumber of the linker code for updating from 0 to (getNumberOfLinkers() - 1).
linkeran object to copy the content from.
Returns
TRUE if the linker code has been found and successfully updated and FALSE otherwise.

◆ validateDeep()

std::string validateDeep ( const ms_xml_schema *  pSchemaFileObj) const
virtual

Performs validation of all child elements in addition to 'shallow' validation.

The current object can be checked against an XML schema. When using this method all possible checks are performed. However, this is not a substitute for the schema: some schema-defined constraint are not applied (unique fields, foreign keys etc.).

In order to make sure that current object is free from all syntax errors validate it as a part of the whole document.

See also
validateShallow(), getSchemaType()
Parameters
pSchemaFileObja valid schema object instance to validate against.
Returns
user-friendly description of any errors found during validation or an empty string if no errors detected.

◆ validateShallow()

std::string validateShallow ( const ms_xml_schema *  pSchemaFileObj) const
virtual

Performs simple validation of the top-level elements only.

The current object can be checked against some basic constraints in a schema without looking at children element types. When using this method only the current object and children derived from standard types (for example, restrictions with enumerations) are checked. For more thorough validation, use validateDeep().

See also
getSchemaType()
Parameters
pSchemaFileObja valid schema object instance to validate against.
Returns
user-friendly description of any errors found during validation or an empty string if no errors detected.

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