Remastered-Collection/REDALERT/PACKET.H

//
// Copyright 2020 Electronic Arts Inc.
//
// TiberianDawn.DLL and RedAlert.dll and corresponding source code is free 
// software: you can redistribute it and/or modify it under the terms of 
// the GNU General Public License as published by the Free Software Foundation, 
// either version 3 of the License, or (at your option) any later version.

// TiberianDawn.DLL and RedAlert.dll and corresponding source code is distributed 
// in the hope that it will be useful, but with permitted additional restrictions 
// under Section 7 of the GPL. See the GNU General Public License in LICENSE.TXT 
// distributed with this program. You should have received a copy of the 
// GNU General Public License along with permitted additional restrictions 
// with this program. If not, see https://github.com/electronicarts/CnC_Remastered_Collection

/***************************************************************************
 *                                                                         *
 *                 Project Name : Westwood Auto Registration App           *
 *                                                                         *
 *                    File Name : PACKET.H                                 *
 *                                                                         *
 *                   Programmer : Philip W. Gorrow                         *
 *                                                                         *
 *                   Start Date : 04/19/96                                 *
 *                                                                         *
 *                  Last Update : April 19, 1996 [PWG]                     *
 *                                                                         *
 * This header defines the functions for the PacketClass.  The packet      *
 * class is used to create a linked list of field entries which can be     *
 * converted to a linear packet in a COMMS API compatible format.          *
 *																									*
 * Packets can be created empty and then have fields added to them or can  *
 * be created from an existing linear packet.  										*
 *																									*
 *-------------------------------------------------------------------------*
 * Functions:                                                              *
 * - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
#ifndef __PACKET_H
#define __PACKET_H


#include "field.h"

class PacketClass {
	public:
		PacketClass(short id = 0)
		{
			Size 			= 0;
			ID				= id;
			Head			= 0;
		}
		PacketClass(char *cur_buf);
		~PacketClass(void);

		//
		// This function allows us to add a field to the start of the list.  As the field is just
		//   a big linked list it makes no difference which end we add a member to.
		//
		void Add_Field(FieldClass *field);

		//
		// These conveniance functions allow us to add a field directly to the list without
		// having to worry about newing one first.
		//
		void Add_Field(char *field, char data) {Add_Field(new FieldClass(field, data));};
		void Add_Field(char *field, unsigned char data) {Add_Field(new FieldClass(field, data));};
		void Add_Field(char *field, short data) {Add_Field(new FieldClass(field, data));};
		void Add_Field(char *field, unsigned short data) {Add_Field(new FieldClass(field, data));};
		void Add_Field(char *field, long data) {Add_Field(new FieldClass(field, data));};
		void Add_Field(char *field, unsigned long data) {Add_Field(new FieldClass(field, data));};
		void Add_Field(char *field, char *data) {Add_Field(new FieldClass(field, data));};
		void Add_Field(char *field, void *data, int length) {Add_Field(new FieldClass(field, data, length));};

		//
		// These functions search for a field of a given name in the list and
		// return the data via a reference value.
		//
		FieldClass *Find_Field(char *id);
		bool Get_Field(char *id, char &data);
		bool Get_Field(char *id, unsigned char &data);
		bool Get_Field(char *id, short &data);
		bool Get_Field(char *id, unsigned short &data);
		bool Get_Field(char *id, long &data);
		bool Get_Field(char *id, unsigned long &data);
		bool Get_Field(char *id, char *data);
		bool Get_Field(char *id, void *data, int &length);

		char *Create_Comms_Packet(int &size);

	private:
		unsigned short 	Size;
		short 				ID;
		FieldClass			*Head;
		FieldClass			*Current;
};


#endif