139 lines
4.4 KiB
C
139 lines
4.4 KiB
C
// header file
|
|
#include "CourseUtilities.h"
|
|
#include "BasicUtilities.h"
|
|
#include <stdlib.h>
|
|
#include <stdio.h>
|
|
|
|
// function implementations
|
|
|
|
/*
|
|
Name: addCourseWithData
|
|
Process: adds course data struct to array and returns true,
|
|
returns false if array is full
|
|
Function input/parameters: course data array (CourseArrayType *),
|
|
course name (const char *),
|
|
course size (int), course availability (bool)
|
|
Function output/parameters: updated course data array (CourseArrayType *)
|
|
Function output/returned: Boolean result of operation (bool)
|
|
Device input/---: none
|
|
Device output/---: none
|
|
Dependencies: as needed, with copyString
|
|
*/
|
|
bool addCourseWithData( CourseArrayType *courseData, const char *courseName,
|
|
int courseSize, bool courseAvailability )
|
|
{
|
|
if( courseData->size < courseData->capacity )
|
|
{
|
|
copyString( courseData->array[ courseData->size ].courseName,
|
|
courseName );
|
|
courseData->array[ courseData->size ].size = courseSize;
|
|
|
|
courseData->array[ courseData->size ].available = courseAvailability;
|
|
|
|
courseData->size = courseData->size + 1;
|
|
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/*
|
|
Name: addCourseWithCourse
|
|
Process: adds course data to array and returns true,
|
|
returns false if array is full
|
|
Function input/parameters: source course data array (const CourseArrayType *)
|
|
Function output/parameters: destination course data array (CourseArrayType *)
|
|
Function output/returned: Boolean result of operation (bool)
|
|
Device input/---: none
|
|
Device output/---: none
|
|
Dependencies: addCourseWithData - one line of code
|
|
*/
|
|
void addCourseWithCourse( CourseArrayType *destCourse,
|
|
const CourseDataType srcCourse )
|
|
{
|
|
addCourseWithData( destCourse, srcCourse.courseName,
|
|
srcCourse.size, srcCourse.available );
|
|
}
|
|
|
|
/*
|
|
Name: clearCourseArray
|
|
Process: frees CourseArrayType memory, along with array memory, returns NULL
|
|
Function input/parameters: course array structure (CourseArrayType *)
|
|
Function output/parameters: none
|
|
Function output/returned: NULL (CourseArrayType *)
|
|
Device input/---: none
|
|
Device output/---: none
|
|
Dependencies: free
|
|
*/
|
|
CourseArrayType *clearCourseArray( CourseArrayType *courseData )
|
|
{
|
|
free( courseData->array );
|
|
|
|
free( courseData );
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/*
|
|
Name: createCourseArray
|
|
Process: allocates CourseArrayType memory, along with array memory,
|
|
returns pointer to new course
|
|
Function input/parameters: initial capacity
|
|
Function output/parameters: none
|
|
Function output/returned: created course (CourseArrayType *)
|
|
Device input/---: none
|
|
Device output/---: none
|
|
Dependencies: malloc, with keyword sizeof
|
|
*/
|
|
CourseArrayType *createCourseArray( int initCapacity )
|
|
{
|
|
CourseArrayType *newCourse
|
|
= (CourseArrayType *)malloc( sizeof( CourseArrayType ) );
|
|
|
|
newCourse->array
|
|
= (CourseDataType *)malloc( initCapacity * sizeof( CourseDataType ) );
|
|
|
|
newCourse->capacity = initCapacity;
|
|
|
|
newCourse->size = 0;
|
|
|
|
return newCourse;
|
|
}
|
|
|
|
/*
|
|
Name: deepCopyCourse
|
|
Process: copies source course data into destination course
|
|
Function input/parameters: source course data (const CourseDataType)
|
|
Function output/parameters: destination course data (CourseDataType *)
|
|
Function output/returned: none
|
|
Device input/---: none
|
|
Device output/---: none
|
|
Dependencies: as needed, including copyString
|
|
*/
|
|
void deepCopyCourse( CourseDataType *destCourse,
|
|
const CourseDataType srcCourse )
|
|
{
|
|
copyString( destCourse->courseName, srcCourse.courseName );
|
|
destCourse->size = srcCourse.size;
|
|
destCourse->available = srcCourse.available;
|
|
}
|
|
|
|
/*
|
|
Name: setCourseDataString
|
|
Process: course data into string, in format:
|
|
"Course Name: <course name>, Course Size: <course size>"
|
|
Function input/parameters: course data (const CourseDataType)
|
|
Function output/parameters: loaded c-style string (char *)
|
|
Function output/returned: none
|
|
Device input/---: none
|
|
Device output/---: none
|
|
Dependencies: sprintf
|
|
*/
|
|
void setCourseDataString( char *dataStr, const CourseDataType courseData )
|
|
{
|
|
sprintf( dataStr, "Course Name: %s, Course Size: %3d",
|
|
courseData.courseName, courseData.size );
|
|
}
|
|
|
|
|