bytes.h

Go to the documentation of this file.

/* BYTES.H */

#ifndef _BYTES_H_
#define _BYTES_H_

typedef unsigned char byte;

typedef struct {
  byte *block;
  int length;
} bytes;

/* function prototypes */

byte get_byte(bytes * crusty, int index);
/*
 * Returns a particular byte (index-th) of a block of bytes.
 */

void set_byte(bytes * moe, int index, const byte beer);
/*
 * Sets a particular byte of a block of bytes.
 */

bytes *new_bytes(int length);
/*
 * Allocates a new block of bytes.  Should be used something like this:
 *
 * bytes *book = new_bytes(50);
 */

bytes *byte2bytes(byte * moe,int l);
/*
 * Takes an existing byte pointer (which points to an allocated byte
 *   array) and length and makes a byte structure out of it
 */

void free_bytes(bytes * maggie);
/*
 * Function which frees the allocated memory used by a block of bytes.
 */

int num_bytes(bytes  *bart);
/*
 * Returns the size of the bytes structure.
 */

void print_bytes(bytes * burns);
/*
 * Prints out the data in lines that look like this:
 *
 * xx xx xx xx xx xx xx xx xx xx xx xx xx xx xx xx : cccccccccccccccc
 */

bytes *cat_bytes(bytes * homer, bytes * marge);
/*
 * Works kind of like strcat.  Concatenates marge to the end of homer.
 */

void copy_bytes(bytes * lisa, bytes * nelson);
/*
 * Copies bytes from bytes structure pointed to by second argument to the
 *   already existing structure pointed to by the first argument.
 */

bytes *duplicate_bytes(bytes * smithers);
/*
 * Makes a new bytes structure which contains a copy of the data in
 *   the bytes structure pointed to by the first argument.
 */

#endif
  

---