NAME

       g2cutil.c - Internal utility functions for the NCEPLIBS-g2c library for the new g2c API.

SYNOPSIS

       #include 'grib2_int.h'
       #include <stdarg.h>

   Functions
       int g2c_log_file (int g2cid)
           Print a summary of the contents of an open GRIB2 file.
       int g2c_log_section (G2C_SECTION_INFO_T *sec)
           Log info about a section.
       int g2c_log_section1 (G2C_MESSAGE_INFO_T *msg)
           Log section 0 information.
       const char * g2c_strerror (int g2cerr)
           Given an error code, return an error message.

   Variables
       G2C_FILE_INFO_T g2c_file [G2C_MAX_FILES+1]
           Global file information.
       G2C_CODE_TABLE_T * g2c_table
           Pointer to the list of code tables.

Detailed Description

       Internal utility functions for the NCEPLIBS-g2c library for the new g2c API.

       Author
           Ed Hartnett

       Date
           Oct 11, 2023

       Definition in file g2cutil.c.

Function Documentation

   int g2c_log_file (int g2cid)
       Print a summary of the contents of an open GRIB2 file. If the NCEPLIBS-g2c library is built without the
       LOGGING option, this function will do nothing.

       Parameters
           g2cid The file ID, returned by g2c_open() or g2c_create().

       Returns

           • G2C_NOERROR No error.

           • G2C_EBADID g2cid not found.

       Author
           Ed Hartnett 8/22/22

       Definition at line 189 of file g2cutil.c.

       References   g2c_message_info::bytes_in_msg,   g2c_message_info::bytes_to_msg,  g2c_message_info::center,
       g2c_message_info::day,  g2c_csv_init(),  G2C_EBADID,  g2c_file,   g2c_free_tables(),   g2c_log_section(),
       g2c_log_section1(), G2C_NOERROR, g2c_table, g2c_message_info::hour, g2c_message_info::local_version, LOG,
       g2c_message_info::master_version,            g2c_message_info::minute,           g2c_message_info::month,
       g2c_message_info::msg_num, g2c_message_info::next, g2c_section_info::next,  g2c_message_info::num_fields,
       g2c_message_info::num_local, g2c_message_info::sec, g2c_message_info::sec1_len, g2c_message_info::second,
       g2c_message_info::sig_ref_time,           g2c_message_info::status,          g2c_message_info::subcenter,
       g2c_message_info::type, and g2c_message_info::year.

       Referenced by read_metadata().

   int g2c_log_section (G2C_SECTION_INFO_T * sec)
       Log info about a section.

       Parameters
           sec Pointer to G2C_SECTION_INFO_T.

       Returns

           • G2C_NOERROR No error.

       Author
           Ed Hartnett 10/20/22

       Definition at line 152 of file g2cutil.c.

       References   g2c_section_info::bytes_to_sec,    g2c_message_info::discipline,    G2C_MAX_NOAA_ABBREV_LEN,
       G2C_NOERROR,      g2c_param_abbrev(),      LOG,      g2c_section_info::msg,     g2c_section_info::sec_id,
       g2c_section_info::sec_len, g2c_section_info::sec_num, and g2c_section_info::template.

       Referenced by g2c_log_file().

   int g2c_log_section1 (G2C_MESSAGE_INFO_T * msg)
       Log section 0 information.

       Parameters
           msg Pointer to G2C_MESSAGE_INFO_T which contains section 0 information.

       Returns

           • G2C_NOERROR No error.

       Author
           Ed Hartnett

       Date
           10/16/22

       Definition at line 101 of file g2cutil.c.

       References g2c_message_info::center, g2c_message_info::day, g2c_message_info::discipline, g2c_csv_init(),
       g2c_find_desc(),          G2C_MAX_GRIB_DESC_LEN,           G2C_NOERROR,           g2c_message_info::hour,
       g2c_message_info::local_version,    LOG,    g2c_message_info::master_version,   g2c_message_info::minute,
       g2c_message_info::month,            g2c_message_info::second,             g2c_message_info::sig_ref_time,
       g2c_message_info::status,         g2c_message_info::subcenter,         g2c_message_info::type,        and
       g2c_message_info::year.

       Referenced by g2c_log_file(), and g2c_open_index().

   const char * g2c_strerror (int g2cerr)
       Given an error code, return an error message.

       Parameters
           g2cerr An error number returned by one of the g2c_* functions.

       Returns
           The error message.

       Author
           Ed Hartnett

       Definition at line 29 of file g2cutil.c.

       References  G2C_EBADEND,  G2C_EBADID,   G2C_EBADSECTION,   G2C_EBADTEMPLATE,   G2C_EBADTYPE,   G2C_EFILE,
       G2C_EINVAL,  G2C_EJPEG, G2C_EMSG, G2C_EMSGCOMPLETE, G2C_ENAMETOOLONG, G2C_ENOEND, G2C_ENOMEM, G2C_ENOMSG,
       G2C_ENOPARAM,   G2C_ENOPRODUCT,    G2C_ENOSECTION,    G2C_ENOTEMPLATE,    G2C_ENOTFOUND,    G2C_ENOTGRIB,
       G2C_ENOTGRIB2, G2C_EPNG, G2C_ETOOMANYFILES, G2C_EXML, and G2C_NOERROR.

Variable Documentation

   G2C_FILE_INFO_T g2c_file[G2C_MAX_FILES+1] [extern]
       Global file information.

       Definition at line 10 of file g2cfile.c.

       Referenced  by  find_available_g2cid(),  free_metadata(),  g2c_add_file(),  g2c_close(), g2c_find_msg2(),
       g2c_get_msg(), g2c_log_file(), g2c_seekmsg(), and read_metadata().

   G2C_CODE_TABLE_T* g2c_table [extern]
       Pointer to the list of code tables.

       Definition at line 16 of file g2ccsv.c.

       Referenced by g2c_csv_init(), g2c_find_desc_str(), g2c_find_table(),  g2c_free_tables(),  g2c_log_file(),
       and g2c_print_tables().

Author

       Generated automatically by Doxygen for NCEPLIBS-g2c from the source code.

NCEPLIBS-g2c                                      Version 2.1.0                                     g2cutil.c(3)