GetPDBChainLabels.c File Reference

#include <stdlib.h>
#include "pdb.h"
#include "macros.h"

Go to the source code of this file.

Functions
char **	blGetPDBChainLabels (PDB *pdb, int *nChains)

Detailed Description

Version

V1.13

Date

26.03.15

Copyright

(c) UCL / Dr. Andrew C. R. Martin 1992-2015

Author

Dr. Andrew C. R. Martin

Institute of Structural & Molecular Biology, University College London, Gower Street, London. WC1E 6BT.

andre.nosp@m.w@bi.nosp@m.oinf..nosp@m.org..nosp@m.uk andre.nosp@m.w.ma.nosp@m.rtin@.nosp@m.ucl..nosp@m.ac.uk

This code is NOT IN THE PUBLIC DOMAIN, but it may be copied according to the conditions laid out in the accompanying file COPYING.DOC.

The code may be modified as required, but any modifications must be documented so that the person responsible can be identified.

The code may not be sold commercially or included as part of a commercial product except as described in the file COPYING.DOC.

Description:

Usage:

Revision History:

• V1.0 22.02.94 Original release
• V1.1 23.05.94 Added FindNextChainPDB()
• V1.2 05.10.94 KillSidechain() uses BOOL rather than int
• V1.3 24.07.95 Added TermPDB()
• V1.4 25.07.95 Added GetPDBChainLabels()
• V1.5 26.09.95 Fixed bug in TermPDB()
• V1.6 12.10.95 Added DupePDB(), CopyPDBCoords()
• V1.7 23.10.95 Moved FindResidueSpec() to ParseRes.c
• V1.8 10.01.96 Added ExtractZonePDB()
• V1.9 14.03.96 Added FindAtomInRes()
• V1.10 08.10.99 Initialised some variables
• V1.11 25.03.14 Deprecated GetPDBChainLabels() and added replacement function blGetPDBChainLabels() By: CTP
• V1.12 31.07.14 Moved GetPDBChainLabels() to dperecated.c By: CTP
• V1.13 26.03.15 blGetPDBChainLabels() no longer assumes all instances of one label occur together By: ACRM

Definition in file GetPDBChainLabels.c.

Function Documentation

char** blGetPDBChainLabels	(	PDB *	pdb,
		int *	nChains
	)

Parameters

[in]	*pdb	PDB linked list
[out]	nChains	Number of chains found.

Returns

Allocated array of strings containing chain labels. NULL if unable to allocate memory.

Scans a PDB linked list for chain names. Allocates memory for an array of strings containing these labels which is returned together with the number of chains found.

N.B. You must free the allocated memory for both the array of chains and for each individual chain label when you've finished with it!

• 25.03.14 Original based on GetPDBChainLabels(). By: CTP
• 26.03.15 No longer assumes chain labels do not appear again later (i.e. chains L,H,Y,L only returns L,H,Y) By: ACRM

Definition at line 118 of file GetPDBChainLabels.c.