/usr/include/genometools/extended/genome_node_api.h is in libgenometools0-dev 1.5.10+ds-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | /*
Copyright (c) 2006-2011 Gordon Gremme <gordon@gremme.org>
Copyright (c) 2006-2008 Center for Bioinformatics, University of Hamburg
Permission to use, copy, modify, and distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
#ifndef GENOME_NODE_API_H
#define GENOME_NODE_API_H
#include "core/fptr_api.h"
#include "core/range_api.h"
#include "core/str_api.h"
typedef struct GtGenomeNodeClass GtGenomeNodeClass;
/* The <GtGenomeNode> interface. The different implementation of the
<GtGenomeNode> interface represent different parts of genome annotations (as
they are usually found in GFF3 files). */
typedef struct GtGenomeNode GtGenomeNode;
#include "extended/node_visitor_api.h"
/* Increase the reference count for <genome_node> and return it.
<genome_node> must not be <NULL>.*/
GtGenomeNode* gt_genome_node_ref(GtGenomeNode *genome_node);
/* Return the sequence ID of <genome_node>.
Corresponds to column 1 of GFF3 feature lines. */
GtStr* gt_genome_node_get_seqid(GtGenomeNode *genome_node);
/* Return the genomic range of of <genome_node>.
Corresponds to columns 4 and 5 of GFF3 feature lines. */
GtRange gt_genome_node_get_range(GtGenomeNode *genome_node);
/* Return the start of <genome_node>.
Corresponds to column 4 of GFF3 feature lines. */
GtUword gt_genome_node_get_start(GtGenomeNode *genome_node);
/* Return the end of <genome_node>.
Corresponds to column 5 of GFF3 feature lines. */
GtUword gt_genome_node_get_end(GtGenomeNode *genome_node);
/* Return the length of <genome_node>.
Computed from column 4 and 5 of GFF3 feature lines. */
GtUword gt_genome_node_get_length(GtGenomeNode *genome_node);
/* Return the filename the <genome_node> was read from.
If the node did not originate from a file, an appropriate string is
returned. */
const char* gt_genome_node_get_filename(const GtGenomeNode* genome_node);
/* Return the line of the source file the <genome_node> was encountered on
(if the node was read from a file, otherwise 0 is returned). */
unsigned int gt_genome_node_get_line_number(const GtGenomeNode*);
/* Set the genomic range of <genome_node> to given <range>. */
void gt_genome_node_set_range(GtGenomeNode *genome_node,
const GtRange *range);
/* Attach a pointer to <data> to the <genome_node> using a given string as
<key>. <free_func> is the optional destructor for <data>. */
void gt_genome_node_add_user_data(GtGenomeNode *genome_node,
const char *key, void *data,
GtFree free_func);
/* Return the pointer attached to the <genome_node> for a given <key>. */
void* gt_genome_node_get_user_data(const GtGenomeNode *genome_node,
const char *key);
/* Call the destructor function associated with the user data attached to
<genome_node> under the <key> on the attached data. */
void gt_genome_node_release_user_data(GtGenomeNode *genome_node,
const char *key);
/* Compare <genome_node_a> with <genome_node_b> and return the result (similar
to <strcmp(3)>). This method is the criterion used to sort genome nodes. */
int gt_genome_node_cmp(GtGenomeNode *genome_node_a,
GtGenomeNode *genome_node_b);
/* Sort node array <nodes> */
void gt_genome_nodes_sort(GtArray *nodes);
/* Sort node array <nodes> in a stable way*/
void gt_genome_nodes_sort_stable(GtArray *nodes);
/* Let <genome_node> accept the <node_visitor>.
In the case of an error, -1 is returned and <err> is set accordingly. */
int gt_genome_node_accept(GtGenomeNode *genome_node,
GtNodeVisitor *node_visitor, GtError *err);
/* Decrease the reference count for <genome_node> or delete it, if this was the
last reference. */
void gt_genome_node_delete(GtGenomeNode *genome_node);
#endif
|