CRU_QUERY (3)
CRU MANUAL
CRU_QUERY (3)

NAME

cru_query - retrieve an attribute associated with a given graph

SYNOPSIS

#include <cru/cru.h>

void *cru_query (
   cru_graph g ,
   int *err )

DESCRIPTION

This function retrieves an attribute previously associated with the graph g by cru_set or initialized as the attribute field of the cru_builder used to build the graph. Unlike the cru_get function, cru_query need not be called from a callback function but the graph g must be specified explicitly as a parameter rather than being inferred automatically.

RETURN VALUE

If cru_query is called with respect to a graph for which no attribute has been set, it returns a NULL value. Otherwise, it returns the attribute.

ERRORS

The err parameter is used to report any events preventing successful completion of the requested operation to the caller. If *err is zero on entry and the operation does not succeed, then *err is assigned a non-zero number. Positive numbers are for POSIX or user-defined error codes, and negative numbers down to -CRU_MAX_ERR are specific to cru.

Values of *err listed below refer to errors that are detected and handled. Unlisted values in the range of -CRU_INT_ERR through -CRU_MAX_ERR likely indicate internal errors attributable to bugs in cru. Any other unlisted values may indicate memory corruption or invalid usage of the API.

CRU_NULGPH

The parameter g refers to an empty graph.

CRU_BADGPH

The parameter g refers to an invalid or corrupted graph.

FILES

/usr/local/include/cru/cru.h

SEE ALSO

cru, cru_bop, cru_bpred, cru_builder, cru_built, cru_cbop, cru_classifier, cru_class_of, cru_class_size, cru_composed, cru_composer, cru_connect, cru_connector, cru_cqop, cru_crossed, cru_crosser, cru_ctop, cru_ctop_pair, cru_ctop_quad, cru_data_types, cru_deduplicated, cru_destructor, cru_destructor_pair, cru_edge_count, cru_fabricated, cru_fabricator, cru_filter, cru_filtered, cru_fold, cru_free_kill_switch, cru_free_later, cru_free_now, cru_free_partition, cru_function_types, cru_get, cru_hash, cru_induced, cru_inducer, cru_kernel, cru_kill, cru_killed, cru_mapreduced, cru_mapreducer, cru_merged, cru_merger, cru_mutated, cru_mutator, cru_new_kill_switch, cru_nop, cru_order, cru_order_pair, cru_partition_of, cru_plan, cru_postponed, cru_postponer, cru_prop, cru_prop_pair, cru_pruner, cru_qop, cru_qpred, cru_set, cru_sig, cru_singleton, cru_split, cru_splitter, cru_spread, cru_strerror, cru_stretch, cru_stretched, cru_stretcher, cru_subconnector, cru_terminus_count, cru_top, cru_tpred, cru_united, cru_uop, cru_vertex_count, cru_zone

AUTHOR

Dennis Furey (milonga@delayinsensitive.com)

PROJECT PAGE

https://codeberg.org/metroman/cru

CRU VERSION 0.29.1
May 03, 2025
CRU_QUERY (3)