drange.h

Go to the documentation of this file.

 
#ifndef __DRANGE_H__
#define __DRANGE_H__
 
#include <wireshark.h>
 
/* Please don't directly manipulate these structs.  Please use
 * the methods provided.  If you REALLY can't do what you need to
 * do with the methods provided please write new methods that do
 * what you need, put them into the drange object here, and limit
 * your direct manipulation of the drange and drange_node structs to
 * here.
 */
 
typedef enum {
    DRANGE_NODE_END_T_UNINITIALIZED, 
    DRANGE_NODE_END_T_LENGTH,        
    DRANGE_NODE_END_T_OFFSET,        
    DRANGE_NODE_END_T_TO_THE_END     
} drange_node_end_t;
 
 
typedef struct _drange_node {
    int start_offset; 
    int length;       
    int end_offset;   
    drange_node_end_t ending; 
} drange_node;
 
 
typedef struct _drange {
    GSList *range_list;    
    bool has_total_length; 
    int total_length;      
    int min_start_offset;  
    int max_start_offset;  
} drange_t;
 
/* drange_node constructor */
 
drange_node* drange_node_new(void);
 
/* drange_node constructor */
 
drange_node* drange_node_from_str(const char *range_str, char **err_ptr);
 
/* drange_node destructor */
 
void drange_node_free(drange_node* drnode);
 
/* Call drange_node destructor on all list items */
void drange_node_free_list(GSList* list);
 
/* drange_node accessors */
 
int drange_node_get_start_offset(drange_node* drnode);
int drange_node_get_length(drange_node* drnode);
 
int drange_node_get_end_offset(drange_node* drnode);
 
drange_node_end_t drange_node_get_ending(drange_node* drnode);
 
/* drange_node mutators */
 
void drange_node_set_start_offset(drange_node* drnode, int offset);
 
void drange_node_set_length(drange_node* drnode, int length);
 
void drange_node_set_end_offset(drange_node* drnode, int offset);
 
void drange_node_set_to_the_end(drange_node* drnode);
 
drange_t * drange_new(drange_node* drnode);
 
drange_t * drange_new_from_list(GSList *list);
 
drange_t * drange_dup(drange_t *org);
 
void drange_free(drange_t* dr);
 
/* drange accessors */
 
bool drange_has_total_length(drange_t* dr);
 
int drange_get_total_length(drange_t* dr);
 
int drange_get_min_start_offset(drange_t* dr);
 
int drange_get_max_start_offset(drange_t* dr);
 
/* drange mutators */
 
void drange_append_drange_node(drange_t* dr, drange_node* drnode);
 
void drange_prepend_drange_node(drange_t* dr, drange_node* drnode);
 
void drange_foreach_drange_node(drange_t* dr, GFunc func, void *funcdata);
 
char *drange_node_tostr(const drange_node *rn);
 
char *drange_tostr(const drange_t *dr);
 
#endif /* ! __DRANGE_H__ */