Annotation of capa/capa51/pProj/capaCommon.h, revision 1.2
1.1 albertel 1:
2: /**********************************************************/
3: /* This header defines Application Interface to the */
4: /* CAPA system. It needs capaParser.h and capaToken.h */
5: /* CAPA version 4.3 */
6: /* Date Oct 23 1995 */
7: /* Isaac Tsai */
8: /* */
9: /* Get rid of old style structure definition *_t */
10: /* Make all structure definition begin with T_ */
11: /* 1997, 1998, 1999 Isaac Tsai */
12: /**********************************************************/
13:
14: #ifndef CAPA_COMMON_H
15: #define CAPA_COMMON_H
16:
17: #include <stdio.h>
18: #ifdef linux
19: #include <stdlib.h>
20: #endif
21: #ifdef NeXT
22: #include <stdlib.h>
23: #include <libc.h>
24: #else
25: #include <malloc.h>
26: #include <unistd.h>
27: #endif
28:
29: #include <math.h>
30: #include <string.h>
31: #include <time.h>
32: #include <sys/fcntl.h> /* lockf() */
33: #include <sys/file.h> /* flock() */
34: #include <sys/types.h>
35: #include "capaParser.h"
36:
37: #ifndef MAX
38: #define MAX(a,b) ((a>b)? (a):(b))
39: #endif
40:
41: #define MAX_SECTION_SIZE 10240 /* Max # of students in the class */
42: #define MAX_SECTION_COUNT 1024
43: #define MAX_NAME_CHAR 30 /* Student's name max length */
44: #define MAX_STUDENT_NUMBER 9 /* Student Number length */
45: #define MAX_EMAIL_CHAR 40 /* Email address */
46: #define FILE_NAME_LENGTH 1024
47: #define MAX_PIN_CHAR 4
48: #define MAX_BUFFER_SIZE 2048
49: #define TMP_LINE_LENGTH 2048 /* used to read in log.db set.db dates.db */
50: #define SMALL_LINE_BUFFER 128 /* used to read classl, active.db */
51: #define SETDB_BUF_SIZE (256*1024)
52: /* user input string length now in capaParser.h*/
53: /*#define ANSWER_STRING_LENG 81*/
54: /*#define UNIT_STRING_LENG 64*/
55: #define FORMAT_STRING_LENG 32
56:
57: /* -------- used in check_date() */
58: #define CHECK_OPEN_DATE 1
59: #define CHECK_DUE_DATE 2
60: #define CHECK_ANS_DATE 3
61:
62:
63:
64: /******************************************************************************/
65: /* STRUCTURE FOR THE HEADER OF A DATABASE FILE */
66: /******************************************************************************/
67:
68: typedef struct {
69: char num_questions[FORMAT_STRING_LENG];
70: char *weight;
71: char *partial_credit;
72: } T_header;
73:
74: /******************************************************************************/
75: /* STRUCTURE FOR A NORMAL DATABASE FILE ENTRY */
76: /******************************************************************************/
77:
78: typedef struct {
79: char student_number[MAX_STUDENT_NUMBER+1]; /* Student number */
80: int e_probs;
81: char *answers; /* String of answers */
82: char *tries;
83: } T_entry;
84:
85: /******************************************************************************/
86: /* STRUCTURE FOR A STUDENT IN THE STUDENT ARRAY */
87: /******************************************************************************/
88:
89: typedef struct _student {
90: struct _student *s_next;
91: struct _student *s_prev;
92: int s_sec;
93: int s_scores;
94: char s_key[MAX_NAME_CHAR+MAX_NAME_CHAR+2]; /* sorting key */
95: char s_sn[MAX_STUDENT_NUMBER+1];
96: char s_nm[MAX_NAME_CHAR+1];
97: char s_email[MAX_EMAIL_CHAR+1];
98: int s_capaid;
99: } T_student;
100:
101: /******************************************************************************/
102: /* STRUCTURE FOR Login dates for a set */
103: /******************************************************************************/
104: /*section number DATE_DEFAULTs contains the default dates an assignment is due*/
105: #define DATE_DEFAULTS 0
106: #define OPEN_OFFSET 0
107: #define DUE_OFFSET 17
108: #define ANSWER_OFFSET 34
109: #define DATE_LENGTH 16
110: #define DATE_BUFFER 17
111: #define OPTION_INHIBIT_RESPONSE 100
112: #define OPTION_VIEW_PROBLEMS_AFTER_DUE 101
113: typedef struct _date {
114: struct _date *s_next;
115: int section_start;
116: int section_end;
117: char open_date[DATE_BUFFER];
118: char due_date[DATE_BUFFER];
119: char answer_date[DATE_BUFFER];
120: char duration[DATE_BUFFER];
121: int inhibit_response;
122: int view_problems_after_due;
123: } T_dates;
124:
125: /******************************************************************************/
126: /* STRUCTURE FOR Login history for a student */
127: /******************************************************************************/
128: typedef struct {
129: int count; /* Number of questions */
130: char *answers; /* String of answers */
131: } login_history_t;
132:
133: #define leap_year(yr) ((yr) <= 1752 ? !((yr) % 4) : !((yr) % 4) && (((yr) % 100) || !((yr) % 400)))
134:
135: #define centuries_since_1700(yr) ((yr) > 1700 ? (yr) / 100 - 17 : 0)
136:
137: #define quad_centuries_since_1700(yr) ((yr) > 1600 ? ((yr) - 1600) / 400 : 0)
138:
139: #define leap_years_since_year_1(yr) ((yr) / 4 - centuries_since_1700(yr) + quad_centuries_since_1700(yr))
140:
141: /*=============================================================================*/
142: /* CAPA PROTOTYPES FOR FUNCTIONS IN COMMON.C */
143: /*=============================================================================*/
144: /*-----------------------------------------------------------------------------*/
145: int capa_get_section CAPA_ARG((T_student **student_pp, int section));
146: int capa_sorted_section CAPA_ARG((T_student **student_pp, int section));
147: void msort_main CAPA_ARG((T_student **head_pp));
148: void msort_split CAPA_ARG((T_student *a_sp, T_student **b_pp));
149: void msort_merge CAPA_ARG((T_student *a_sp, T_student *b_sp, T_student **c_pp));
150: int capa_get_student CAPA_ARG((char *student_number,T_student *student_p));
151: int capa_student_byname CAPA_ARG((char *student_name,T_student *student_p));
152: int capa_pick_student CAPA_ARG((int section, T_student *student_p));
153: int capa_add_student CAPA_ARG((T_student *student_p));
154: int capa_parse CAPA_ARG((int set,Problem_t **problem,char *student_number,int *num_questions,void (*func_ptr)()));
155: int capa_parse_student CAPA_ARG((int set,Problem_t **problem,T_student *astudent,int *num_questions,void (*func_ptr)()));
156: void free_problems CAPA_ARG((Problem_t *problem_p));
157: void free_students CAPA_ARG((T_student *student_p));
158: void free_units CAPA_ARG(());
159: int read_capa_config CAPA_ARG((char* key_word, char *value));
160: int capa_access CAPA_ARG((const char *pathname, int mode));
161: /*-----------------------------------------------------------------------------*/
162: void capa_seed CAPA_ARG((long *seed1, long *seed2, char *student_number));
163: int capa_PIN CAPA_ARG((char *student_number, int set, int guess));
164: char* capa_id_plus CAPA_ARG((char *student_number, int set, int plus));
165: int capa_set_header CAPA_ARG((T_header *header, int set));
166: int capa_get_header CAPA_ARG((T_header *header, int set));
167:
168: int capa_set_entry CAPA_ARG((T_entry *entry, char *student_number, int set, long offset));
169: int capa_change_entry CAPA_ARG((T_entry *entry, char *student_number, int set));
170: long capa_append_entry CAPA_ARG((T_entry *entry, char *student_number, int set));
171: long capa_get_entry CAPA_ARG((T_entry *entry, char *student_number, int set));
172: int capa_excuse CAPA_ARG((int set, int prob, int section));
173: int capa_get_score CAPA_ARG((char *student_number, int set, int *valid_scores, char **answers_pp));
174: char* capa_get_seat CAPA_ARG((char *studentnum, char *seatfile));
175: /*-----------------------------------------------------------------------------*/
176: int capa_get_login_count CAPA_ARG((char *student_number,int set));
177: int capa_get_login_db CAPA_ARG((T_entry *login_item,int *num_probs,int set));
178: int capa_get_section_count CAPA_ARG((int *cnt_arry));
179: int login_check CAPA_ARG((char *student_number));
180: int logout_check CAPA_ARG((char *student_number));
181: /*-----------------------------------------------------------------------------*/
182: int flockstream_sh CAPA_ARG((FILE *fp));
183: int flockstream CAPA_ARG((FILE *fp));
184: int funlockstream CAPA_ARG((FILE *fp));
185: /*-----------------------------------------------------------------------------*/
186: time_t convertTime CAPA_ARG((char *dateStr,char *timeStr));
187: int weekday CAPA_ARG((int year, int month, int day));
188: int julianday CAPA_ARG((int year, int month, int day));
189: /*int compare_datetime CAPA_ARG((time_t time,char *datetime));*/
190: int capa_check_date CAPA_ARG((int which,char *student_number,int section,int set));
191: int capa_get_date CAPA_ARG((int which,char *student_number,int section,int set,char *date_str));
192: void free_dates CAPA_ARG((T_dates *dates));
193: int capa_get_all_dates CAPA_ARG((int set, T_dates **dates));
194: int capa_set_all_dates CAPA_ARG((int set, T_dates *dates));
195: int capa_get_section_dates CAPA_ARG((int section,int set,T_dates** dates));
196: T_dates* add_date_info CAPA_ARG((int lowsec,int highsec, char *dateinfo));
197: int capa_get_login_time CAPA_ARG((char *student_number,int set,time_t *logintime));
198: int capa_set_login_time CAPA_ARG((char *student_number,int set));
199: int capa_get_duration CAPA_ARG((char *student_number,int section,int set));
200: int capa_check_option CAPA_ARG((int option,int set,int section));
201: int check_int CAPA_ARG((char *an_int ));
202: int check_real CAPA_ARG((char *a_real ));
203: char *answers_string CAPA_ARG((int mode, Problem_t *p ));
1.2 ! albertel 204: int capa_check_ans CAPA_ARG((AnswerInfo_t *ai, char *answer, char **error));
! 205: int capa_check_answer CAPA_ARG((Problem_t *p, char *answer, char **error));
! 206: int capa_check_answers CAPA_ARG((Problem_t *p, char **answers,int cnt, char **error));
1.1 albertel 207: int check_formula_ans CAPA_ARG((char *fml_str,char *input_str,char *var_list,PointsList_t *pts_list,int tol_type,double tol));
208:
209: int is_all_ws CAPA_ARG((char *answer));
210: void trim_response_ws CAPA_ARG((char *answer));
211: void throwaway_line CAPA_ARG((FILE* fp));
212: void protect_log_string CAPA_ARG((char* log_string));
213: int calc_ansrange CAPA_ARG((int type,int calc_type,char *input,char *fmt,int tol_type,double tol,char *lower,char *upper));
214: /*-----------------------------------------------------------------------------*/
215: int capa_set_subjective CAPA_ARG((int set,int problem,char *student_num,char* response));
216: char* capa_get_subjective CAPA_ARG((int set,int problem,char *student_num));
217: /*============================================================================*/
218:
219: #endif /* CAPA_COMMON_H */
220:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>