X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/e39d3a7637657a34fe154348228c07842430828d..da8ec666c391d382638f3ef518a30650ff08b436:/include/xbt/graph.h diff --git a/include/xbt/graph.h b/include/xbt/graph.h index fa192a0042..70d094f78a 100644 --- a/include/xbt/graph.h +++ b/include/xbt/graph.h @@ -1,20 +1,21 @@ -/* Copyright (c) 2006-2007, 2009-2014. The SimGrid Team. - * All rights reserved. */ +/* Copyright (c) 2006-2021. The SimGrid Team. All rights reserved. */ /* This program is free software; you can redistribute it and/or modify it * under the terms of the license (GNU LGPL) which comes with this package. */ -#ifndef _XBT_GRAPH_H -#define _XBT_GRAPH_H -#include "xbt/misc.h" /* SG_BEGIN_DECL */ -#include "xbt/dynar.h" -SG_BEGIN_DECL() +#ifndef XBT_GRAPH_H +#define XBT_GRAPH_H - /** @addtogroup XBT_graph - * @brief A graph data type with several interesting algorithms - * - * @{ - */ +#include +#include /* SG_BEGIN_DECL */ + +SG_BEGIN_DECL + +/** @addtogroup XBT_graph + * @brief A graph data type with several interesting algorithms + * + * @{ + */ typedef struct xbt_node *xbt_node_t; typedef struct xbt_edge *xbt_edge_t; @@ -22,67 +23,51 @@ typedef struct xbt_graph *xbt_graph_t; /* Node structure */ /* Be careful of what you do with this structure */ -/* typedef struct xbt_node *xbt_node_t; */ typedef struct xbt_node { xbt_dynar_t out; xbt_dynar_t in; /* not used when the graph is directed */ double position_x; /* positive value: negative means undefined */ double position_y; /* positive value: negative means undefined */ void *data; /* user data */ - void *xbtdata; /* private xbt data: should be reinitialized at the - beginning of your algorithm if you need to use it */ } s_xbt_node_t; /* edge structure */ /* Be careful of what you do with this structure */ -/* typedef struct xbt_edge *xbt_edge_t; */ typedef struct xbt_edge { xbt_node_t src; xbt_node_t dst; void *data; /* user data */ - void *xbtdata; /* private xbt data: should be reinitialized at the - beginning of your algorithm if you need to use it */ - double length; /* positive value: negative means undefined */ } s_xbt_edge_t; /* Graph structure */ /* Be careful of what you do with this structure */ -/* typedef struct xbt_graph *xbt_graph_t; */ typedef struct xbt_graph { xbt_dynar_t nodes; xbt_dynar_t edges; unsigned short int directed; void *data; /* user data */ - void *xbtdata; /* private xbt data: should be reinitialized at the - beginning of your algorithm if you need to use it */ } s_xbt_graph_t; /* API */ -XBT_PUBLIC(xbt_graph_t) xbt_graph_new_graph(unsigned short int directed, void *data); -XBT_PUBLIC(xbt_node_t) xbt_graph_new_node(xbt_graph_t g, void *data); -XBT_PUBLIC(xbt_edge_t) xbt_graph_new_edge(xbt_graph_t g, xbt_node_t src, xbt_node_t dst, void *data); -XBT_PUBLIC(void *) xbt_graph_node_get_data(xbt_node_t node); -XBT_PUBLIC(void) xbt_graph_node_set_data(xbt_node_t node, void *data); -XBT_PUBLIC(void *) xbt_graph_edge_get_data(xbt_edge_t edge); -XBT_PUBLIC(void) xbt_graph_edge_set_data(xbt_edge_t edge, void *data); - -XBT_PUBLIC(xbt_edge_t) xbt_graph_get_edge(xbt_graph_t g, xbt_node_t src, xbt_node_t dst); - -XBT_PUBLIC(void) xbt_graph_edge_set_length(xbt_edge_t e, double length); -XBT_PUBLIC(double) xbt_graph_edge_get_length(xbt_edge_t e); +XBT_PUBLIC xbt_graph_t xbt_graph_new_graph(unsigned short int directed, void* data); +XBT_PUBLIC xbt_node_t xbt_graph_new_node(const s_xbt_graph_t* g, void* data); +XBT_PUBLIC xbt_edge_t xbt_graph_new_edge(const s_xbt_graph_t* g, xbt_node_t src, xbt_node_t dst, void* data); +XBT_PUBLIC void* xbt_graph_node_get_data(const s_xbt_node_t* node); +XBT_PUBLIC void xbt_graph_node_set_data(xbt_node_t node, void* data); +XBT_PUBLIC void* xbt_graph_edge_get_data(const s_xbt_edge_t* edge); +XBT_PUBLIC void xbt_graph_edge_set_data(xbt_edge_t edge, void* data); -XBT_PUBLIC(void) xbt_graph_free_graph(xbt_graph_t g, - void_f_pvoid_t node_free_function, void_f_pvoid_t edge_free_function, void_f_pvoid_t graph_free_function); +XBT_PUBLIC xbt_edge_t xbt_graph_get_edge(const s_xbt_graph_t* g, const s_xbt_node_t* src, const s_xbt_node_t* dst); -XBT_PUBLIC(xbt_dynar_t) xbt_graph_get_nodes(xbt_graph_t g); -XBT_PUBLIC(xbt_dynar_t) xbt_graph_get_edges(xbt_graph_t g); -XBT_PUBLIC(xbt_dynar_t) xbt_graph_node_get_outedges(xbt_node_t n); -XBT_PUBLIC(xbt_node_t) xbt_graph_edge_get_source(xbt_edge_t e); -XBT_PUBLIC(xbt_node_t) xbt_graph_edge_get_target(xbt_edge_t e); +XBT_PUBLIC void xbt_graph_free_graph(xbt_graph_t g, void_f_pvoid_t node_free_function, + void_f_pvoid_t edge_free_function, void_f_pvoid_t graph_free_function); -XBT_PUBLIC(void) xbt_graph_export_graphviz(xbt_graph_t g, const char *filename, - const char *(node_name) (xbt_node_t), const char *(edge_name) (xbt_edge_t)); +XBT_PUBLIC xbt_dynar_t xbt_graph_get_nodes(const s_xbt_graph_t* g); +XBT_PUBLIC xbt_dynar_t xbt_graph_get_edges(const s_xbt_graph_t* g); +XBT_PUBLIC xbt_dynar_t xbt_graph_node_get_outedges(const s_xbt_node_t* n); +XBT_PUBLIC xbt_node_t xbt_graph_edge_get_source(const s_xbt_edge_t* e); +XBT_PUBLIC xbt_node_t xbt_graph_edge_get_target(const s_xbt_edge_t* e); -SG_END_DECL() -#endif /* _XBT_GRAPH_H */ +SG_END_DECL +#endif /* XBT_GRAPH_H */ /** @} */