util.h

Go to the documentation of this file.

/**
 * MOAB, a Mesh-Oriented datABase, is a software component for creating,
 * storing and accessing finite element mesh data.
 * 
 * Copyright 2004 Sandia Corporation.  Under the terms of Contract
 * DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government
 * retains certain rights in this software.
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 * 
 */

#ifndef mhdf_FILE_UTIL_H
#define mhdf_FILE_UTIL_H

#include <sys/types.h>
#include <H5Ipublic.h>
#include "status.h"
#include "file-handle.h"

#ifdef __cplusplus
extern "C" {
#endif

void* mhdf_malloc( size_t size, mhdf_Status* status );
void* mhdf_realloc( void* ptr, size_t size, mhdf_Status* status );

size_t mhdf_name_to_path( const char* name, char* path, size_t path_len );

int mhdf_path_to_name( const char* path, char* name );

char* mhdf_name_to_path_copy( const char* name, mhdf_Status* status );

char* mhdf_name_to_path_cat( const char* prefix, const char* name, mhdf_Status* status );

hid_t mhdf_elem_group_from_handle( FileHandle* file_ptr, const char* elem_handle, mhdf_Status* status );

int mhdf_create_scalar_attrib( hid_t object, const char* name, hid_t type, const void* value, mhdf_Status* status );

/* If type is zero, assumes opaque type.
   On error, sets status and returns zero.
   On success, returns non-zero and does not modify status */
int mhdf_read_scalar_attrib( hid_t object, const char* name, hid_t type, void* value, mhdf_Status* status );

/* Search the specified object to see if it contains an 
   an attribute with passed name.  Returns -1 on error, 1 
   if attribute was found, and zero if attribute was not 
   found.
*/
int mhdf_find_attribute( hid_t object, const char* attrib_name, unsigned int* index_out, mhdf_Status* status );

int mhdf_is_in_group( hid_t group, const char* name, mhdf_Status* status );

int mhdf_read_data( hid_t data_table,
                    long offset,
                    long count,
                    hid_t type,
                    void* array,
                    hid_t read_prop,
                    mhdf_Status* status );

int mhdf_write_data( hid_t data_table,
                     long offset,
                     long count,
                     hid_t type,
                     const void* array,
                     hid_t write_prop,
                     mhdf_Status* status );

int mhdf_read_column( hid_t data_table,
                      int column,
                      long offset,
                      long count,
                      hid_t type,
                      void* array,
                      hid_t read_prop,
                      mhdf_Status* status );

int mhdf_write_column( hid_t data_table,
                       int column,
                       long offset,
                       long count,
                       hid_t type,
                       const void* array,
                       hid_t write_prop,
                       mhdf_Status* status );

hid_t mhdf_create_table( hid_t group, const char* path, hid_t type, int rank, hsize_t* dims, mhdf_Status* status );

hid_t mhdf_create_table_with_prop( hid_t group,
                                   const char* path,
                                   hid_t type,
                                   int rank,
                                   hsize_t* dims,
                                   hid_t dataset_creation_prop,
                                   mhdf_Status* status );

hid_t mhdf_open_table( hid_t group, const char* path, int columns, hsize_t* rows_out, mhdf_Status* status );

hid_t mhdf_open_table2( hid_t group,
                        const char* path,
                        int rank,
                        hsize_t* dims_out,
                        long* start_id_out,
                        mhdf_Status* status );

hid_t mhdf_open_table_simple( hid_t group, const char* path, mhdf_Status* status );

int mhdf_compact_to_ranges( int* length_in_out, int* ids_in, int ordered );

hid_t get_elem_type_enum( FileHandle* file_ptr, mhdf_Status* status );

void mhdf_api_begin_internal( void );
void mhdf_api_end_internal( int expected_diff, const char* filename, int linenumber );

int mhdf_write_max_id( FileHandle* file_ptr, mhdf_Status* status );

#ifndef DEBUG_OPEN_HANDLES
#define API_BEGIN
#define API_END_H( n )
#else
#define API_BEGIN      mhdf_api_begin_internal()
#define API_END_H( n ) mhdf_api_end_internal( n, __FILE__, __LINE__ )
#endif
#define API_END API_END_H( 0 )

#ifdef __cplusplus
} /* extern "C" */
#endif

#endif