g2_addlocal.c File Reference

Add a Local Use Section (Section 2) to a GRIB2 message. More...

#include <stdio.h>
#include "grib2.h"

Go to the source code of this file.

Functions
g2int	g2_addlocal (unsigned char *cgrib, unsigned char *csec2, g2int lcsec2)
	This routine adds a Local Use Section (Section 2) to a GRIB2 message. More...

Detailed Description

Add a Local Use Section (Section 2) to a GRIB2 message.

Author

Stephen Gilbeert

Date

2002-11-01

Definition in file g2_addlocal.c.

Function Documentation

g2_addlocal()

g2int g2_addlocal	(	unsigned char *	cgrib,
		unsigned char *	csec2,
		g2int	lcsec2
	)

This routine adds a Local Use Section (Section 2) to a GRIB2 message.

It is used with routines g2_create(), g2_addgrid(), g2_addfield(), and g2_gribend() to create a complete GRIB2 message. g2_create() must be called first to initialize a new GRIB2 message.

Parameters

cgrib	Char array that contains the GRIB2 message to which section 2 should be added. Must be allocated large enough to store the entire GRIB2 message.
csec2	Character array containing information to be added in Section 2.
lcsec2	Number of bytes of character array csec2 to be added to Section 2.

Returns

> 0 = Current size of updated GRIB2 message.

• -1 GRIB message was not initialized. Need to call routine gribcreate first.
• -2 GRIB message already complete. Cannot add new section.
• -3 Sum of Section byte counts doesn't add to total byte count
• -4 Previous Section was not 1 or 7.

Note

The Local Use Section (Section 2) can only follow Section 1 or Section 7 in a GRIB2 message.

Author

Stephen Gilbeert

Date

2002-11-01

Definition at line 37 of file g2_addlocal.c.

References gbit(), and sbit().