Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Keep deprecated wrappers "virtual".
[simgrid.git] / include / xbt / graph.h
1 /* Copyright (c) 2006-2019. The SimGrid Team. All rights reserved.          */
2
3 /* This program is free software; you can redistribute it and/or modify it
4  * under the terms of the license (GNU LGPL) which comes with this package. */
5
6 #ifndef XBT_GRAPH_H
7 #define XBT_GRAPH_H
8
9 #include <xbt/dynar.h>
10 #include <xbt/misc.h> /* SG_BEGIN_DECL */
11
12 SG_BEGIN_DECL()
13
14   /** @addtogroup XBT_graph
15    *  @brief A graph data type with several interesting algorithms
16    *
17    * @{
18    */
19
20 typedef struct xbt_node *xbt_node_t;
21 typedef struct xbt_edge *xbt_edge_t;
22 typedef struct xbt_graph *xbt_graph_t;
23
24 /* Node structure */
25 /* Be careful of what you do with this structure */
26 typedef struct xbt_node {
27   xbt_dynar_t out;
28   xbt_dynar_t in;               /* not used when the graph is directed */
29   double position_x;            /* positive value: negative means undefined */
30   double position_y;            /* positive value: negative means undefined */
31   void *data;                   /* user data */
32 } s_xbt_node_t;
33
34 /* edge structure */
35 /* Be careful of what you do with this structure */
36 typedef struct xbt_edge {
37   xbt_node_t src;
38   xbt_node_t dst;
39   void *data;                   /* user data */
40 } s_xbt_edge_t;
41
42 /* Graph structure */
43 /* Be careful of what you do with this structure */
44 typedef struct xbt_graph {
45   xbt_dynar_t nodes;
46   xbt_dynar_t edges;
47   unsigned short int directed;
48   void *data;                   /* user data */
49 } s_xbt_graph_t;
50
51 /* API */
52 XBT_PUBLIC xbt_graph_t xbt_graph_new_graph(unsigned short int directed, void* data);
53 XBT_PUBLIC xbt_node_t xbt_graph_new_node(xbt_graph_t g, void* data);
54 XBT_PUBLIC xbt_edge_t xbt_graph_new_edge(xbt_graph_t g, xbt_node_t src, xbt_node_t dst, void* data);
55 XBT_PUBLIC void* xbt_graph_node_get_data(xbt_node_t node);
56 XBT_PUBLIC void xbt_graph_node_set_data(xbt_node_t node, void* data);
57 XBT_PUBLIC void* xbt_graph_edge_get_data(xbt_edge_t edge);
58 XBT_PUBLIC void xbt_graph_edge_set_data(xbt_edge_t edge, void* data);
59
60 XBT_PUBLIC xbt_edge_t xbt_graph_get_edge(xbt_graph_t g, xbt_node_t src, xbt_node_t dst);
61
62 XBT_PUBLIC void xbt_graph_free_graph(xbt_graph_t g, void_f_pvoid_t node_free_function,
63                                      void_f_pvoid_t edge_free_function, void_f_pvoid_t graph_free_function);
64
65 XBT_PUBLIC xbt_dynar_t xbt_graph_get_nodes(xbt_graph_t g);
66 XBT_PUBLIC xbt_dynar_t xbt_graph_get_edges(xbt_graph_t g);
67 XBT_PUBLIC xbt_dynar_t xbt_graph_node_get_outedges(xbt_node_t n);
68 XBT_PUBLIC xbt_node_t xbt_graph_edge_get_source(xbt_edge_t e);
69 XBT_PUBLIC xbt_node_t xbt_graph_edge_get_target(xbt_edge_t e);
70
71 SG_END_DECL()
72 #endif /* XBT_GRAPH_H */
73 /** @} */