Subversion Repositories SvarDOS

Rev

Rev 445 | Rev 538 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 445 Rev 530
1
/* This file is part of the SvarCOM project and is published under the terms
1
/* This file is part of the SvarCOM project and is published under the terms
2
 * of the MIT license.
2
 * of the MIT license.
3
 *
3
 *
4
 * Copyright (C) 2021 Mateusz Viste
4
 * Copyright (C) 2021 Mateusz Viste
5
 *
5
 *
6
 * Permission is hereby granted, free of charge, to any person obtaining a
6
 * Permission is hereby granted, free of charge, to any person obtaining a
7
 * copy of this software and associated documentation files (the "Software"),
7
 * copy of this software and associated documentation files (the "Software"),
8
 * to deal in the Software without restriction, including without limitation
8
 * to deal in the Software without restriction, including without limitation
9
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10
 * and/or sell copies of the Software, and to permit persons to whom the
10
 * and/or sell copies of the Software, and to permit persons to whom the
11
 * Software is furnished to do so, subject to the following conditions:
11
 * Software is furnished to do so, subject to the following conditions:
12
 *
12
 *
13
 * The above copyright notice and this permission notice shall be included in
13
 * The above copyright notice and this permission notice shall be included in
14
 * all copies or substantial portions of the Software.
14
 * all copies or substantial portions of the Software.
15
 *
15
 *
16
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
22
 * DEALINGS IN THE SOFTWARE.
22
 * DEALINGS IN THE SOFTWARE.
23
 */
23
 */
24
 
24
 
25
#ifndef HELPERS_H
25
#ifndef HELPERS_H
26
#define HELPERS_H
26
#define HELPERS_H
27
 
27
 
28
/* case-insensitive comparison of strings, returns non-zero on equality */
28
/* case-insensitive comparison of strings, compares up to maxlen characters.
-
 
29
 * returns non-zero on equality. */
29
int imatch(const char *s1, const char *s2);
30
int imatchlim(const char *s1, const char *s2, unsigned short maxlen);
-
 
31
 
-
 
32
#define imatch(a,b) imatchlim(a,b,0xffff)
30
 
33
 
31
/* returns zero if s1 starts with s2 */
34
/* returns zero if s1 starts with s2 */
32
int strstartswith(const char *s1, const char *s2);
35
int strstartswith(const char *s1, const char *s2);
33
 
36
 
34
/* outputs a NULL-terminated string to stdout */
37
/* outputs a NULL-terminated string to stdout */
35
void output_internal(const char *s, unsigned char nl);
38
void output_internal(const char *s, unsigned char nl);
36
 
39
 
37
/* outputs a NULL-terminated NLS string to stdout */
40
/* outputs a NULL-terminated NLS string to stdout */
38
void nls_output_internal(unsigned short id, unsigned char nl);
41
void nls_output_internal(unsigned short id, unsigned char nl);
39
 
42
 
40
#define output(x) output_internal(x, 0)
43
#define output(x) output_internal(x, 0)
41
#define outputnl(x) output_internal(x, 1)
44
#define outputnl(x) output_internal(x, 1)
42
#define nls_output(x,y) nls_output_internal((x << 8) | y, 0)
45
#define nls_output(x,y) nls_output_internal((x << 8) | y, 0)
43
#define nls_outputnl(x,y) nls_output_internal((x << 8) | y, 1)
46
#define nls_outputnl(x,y) nls_output_internal((x << 8) | y, 1)
44
 
47
 
45
/*
48
/*
46
 * FileInfoRec (DTA) format:
49
 * FileInfoRec (DTA) format:
47
 * offset size desc
50
 * offset size desc
48
 *    +0   21  reserved
51
 *    +0   21  reserved
49
 *  +15h    1  file attr (1=RO 2=Hidden 4=System 8=VOL 16=DIR 32=Archive
52
 *  +15h    1  file attr (1=RO 2=Hidden 4=System 8=VOL 16=DIR 32=Archive
50
 *  +16h    2  time: bits 0-4=bi-seconds (0-30), bits 5-10=minutes (0-59), bits 11-15=hour (0-23)
53
 *  +16h    2  time: bits 0-4=bi-seconds (0-30), bits 5-10=minutes (0-59), bits 11-15=hour (0-23)
51
 *  +18h    2  date: bits 0-4=day(0-31), bits 5-8=month (1-12), bits 9-15=years since 1980
54
 *  +18h    2  date: bits 0-4=day(0-31), bits 5-8=month (1-12), bits 9-15=years since 1980
52
 *  +1ah    4  DWORD file size, in bytes
55
 *  +1ah    4  DWORD file size, in bytes
53
 *  +1eh   13  13-bytes max ASCIIZ filename
56
 *  +1eh   13  13-bytes max ASCIIZ filename
54
 */
57
 */
55
_Packed struct DTA {
58
_Packed struct DTA {
56
  char reserved[21];
59
  char reserved[21];
57
  unsigned char attr;
60
  unsigned char attr;
58
  unsigned short time_sec2:5;
61
  unsigned short time_sec2:5;
59
  unsigned short time_min:6;
62
  unsigned short time_min:6;
60
  unsigned short time_hour:5;
63
  unsigned short time_hour:5;
61
  unsigned short date_dy:5;
64
  unsigned short date_dy:5;
62
  unsigned short date_mo:4;
65
  unsigned short date_mo:4;
63
  unsigned short date_yr:7;
66
  unsigned short date_yr:7;
64
  unsigned long size;
67
  unsigned long size;
65
  char fname[13];
68
  char fname[13];
66
};
69
};
67
 
70
 
68
 
71
 
69
/* this is also known as the "Country Info Block" or "CountryInfoRec":
72
/* this is also known as the "Country Info Block" or "CountryInfoRec":
70
 * offset size desc
73
 * offset size desc
71
 *   +0      2   wDateFormat  0=USA (m d y), 1=Europe (d m y), 2=Japan (y m d)
74
 *   +0      2   wDateFormat  0=USA (m d y), 1=Europe (d m y), 2=Japan (y m d)
72
 *   +2      5  szCrncySymb  currency symbol (ASCIIZ)
75
 *   +2      5  szCrncySymb  currency symbol (ASCIIZ)
73
 *   +7      2  szThouSep    thousands separator (ASCIIZ)
76
 *   +7      2  szThouSep    thousands separator (ASCIIZ)
74
 *   +9      2  szDecSep     decimal separator (ASCIIZ)
77
 *   +9      2  szDecSep     decimal separator (ASCIIZ)
75
 * +0bH      2  szDateSep    date separator (ASCIIZ)
78
 * +0bH      2  szDateSep    date separator (ASCIIZ)
76
 * +0dH      2  szTimeSep    time separator (ASCIIZ)
79
 * +0dH      2  szTimeSep    time separator (ASCIIZ)
77
 * +0fH      1  bCrncyFlags  currency format flags
80
 * +0fH      1  bCrncyFlags  currency format flags
78
 * +10H      1  bCrncyDigits decimals digits in currency
81
 * +10H      1  bCrncyDigits decimals digits in currency
79
 * +11H      1  bTimeFormat  time format 0=12h 1=24h
82
 * +11H      1  bTimeFormat  time format 0=12h 1=24h
80
 * +12H      4  pfCasemap    Casemap FAR call address
83
 * +12H      4  pfCasemap    Casemap FAR call address
81
 * +16H      2  szDataSep    data list separator (ASCIIZ)
84
 * +16H      2  szDataSep    data list separator (ASCIIZ)
82
 * +18H     10  res          reserved zeros
85
 * +18H     10  res          reserved zeros
83
 *          34               total length
86
 *          34               total length
84
 */
87
 */
85
_Packed struct nls_patterns {
88
_Packed struct nls_patterns {
86
  unsigned short dateformat;
89
  unsigned short dateformat;
87
  char currency[5];
90
  char currency[5];
88
  char thousep[2];
91
  char thousep[2];
89
  char decsep[2];
92
  char decsep[2];
90
  char datesep[2];
93
  char datesep[2];
91
  char timesep[2];
94
  char timesep[2];
92
  unsigned char currflags;
95
  unsigned char currflags;
93
  unsigned char currdigits;
96
  unsigned char currdigits;
94
  unsigned char timefmt;
97
  unsigned char timefmt;
95
  void far *casemapfn;
98
  void far *casemapfn;
96
  char datalistsep[2];
99
  char datalistsep[2];
97
  char reserved[10];
100
  char reserved[10];
98
};
101
};
99
 
102
 
100
 
103
 
101
#define DOS_ATTR_RO   1
104
#define DOS_ATTR_RO   1
102
#define DOS_ATTR_HID  2
105
#define DOS_ATTR_HID  2
103
#define DOS_ATTR_SYS  4
106
#define DOS_ATTR_SYS  4
104
#define DOS_ATTR_VOL  8
107
#define DOS_ATTR_VOL  8
105
#define DOS_ATTR_DIR 16
108
#define DOS_ATTR_DIR 16
106
#define DOS_ATTR_ARC 32
109
#define DOS_ATTR_ARC 32
107
 
110
 
108
/* find first matching files using a FindFirst DOS call
111
/* find first matching files using a FindFirst DOS call
109
 * attr contains DOS attributes that files MUST have (ie attr=0 will match all
112
 * attr contains DOS attributes that files MUST have (ie attr=0 will match all
110
 * files)
113
 * files)
111
 * returns 0 on success or a DOS err code on failure */
114
 * returns 0 on success or a DOS err code on failure */
112
unsigned short findfirst(struct DTA *dta, const char *pattern, unsigned short attr);
115
unsigned short findfirst(struct DTA *dta, const char *pattern, unsigned short attr);
113
 
116
 
114
/* find next matching, ie. continues an action intiated by findfirst() */
117
/* find next matching, ie. continues an action intiated by findfirst() */
115
unsigned short findnext(struct DTA *dta);
118
unsigned short findnext(struct DTA *dta);
116
 
119
 
117
/* print s string and wait for a single key press from stdin. accepts only
120
/* print s string and wait for a single key press from stdin. accepts only
118
 * key presses defined in the c ASCIIZ string. returns offset of pressed key
121
 * key presses defined in the c ASCIIZ string. returns offset of pressed key
119
 * in string. keys in c MUST BE UPPERCASE! */
122
 * in string. keys in c MUST BE UPPERCASE! */
120
unsigned short askchoice(const char *s, const char *c);
123
unsigned short askchoice(const char *s, const char *c);
121
 
124
 
122
/* converts a path to its canonic representation, returns 0 on success
125
/* converts a path to its canonic representation, returns 0 on success
123
 * or DOS err on failure (invalid drive) */
126
 * or DOS err on failure (invalid drive) */
124
unsigned short file_truename(const char *src, char *dst);
127
unsigned short file_truename(const char *src, char *dst);
125
 
128
 
126
/* returns DOS attributes of file, or -1 on error */
129
/* returns DOS attributes of file, or -1 on error */
127
int file_getattr(const char *fname);
130
int file_getattr(const char *fname);
128
 
131
 
129
/* returns screen's width (in columns) */
132
/* returns screen's width (in columns) */
130
unsigned short screen_getwidth(void);
133
unsigned short screen_getwidth(void);
131
 
134
 
132
/* returns screen's height (in rows) */
135
/* returns screen's height (in rows) */
133
unsigned short screen_getheight(void);
136
unsigned short screen_getheight(void);
134
 
137
 
135
/* displays the "Press any key to continue" msg and waits for a keypress */
138
/* displays the "Press any key to continue" msg and waits for a keypress */
136
void press_any_key(void);
139
void press_any_key(void);
137
 
140
 
138
/* validate a drive (A=0, B=1, etc). returns 1 if valid, 0 otherwise */
141
/* validate a drive (A=0, B=1, etc). returns 1 if valid, 0 otherwise */
139
int isdrivevalid(unsigned char drv);
142
int isdrivevalid(unsigned char drv);
140
 
143
 
141
/* converts a filename into FCB format (FILENAMEEXT) */
144
/* converts a filename into FCB format (FILENAMEEXT) */
142
void file_fname2fcb(char *dst, const char *src);
145
void file_fname2fcb(char *dst, const char *src);
143
 
146
 
144
/* converts a FCB filename (FILENAMEEXT) into normal format (FILENAME.EXT) */
147
/* converts a FCB filename (FILENAMEEXT) into normal format (FILENAME.EXT) */
145
void file_fcb2fname(char *dst, const char *src);
148
void file_fcb2fname(char *dst, const char *src);
146
 
149
 
147
/* converts an ASCIIZ string into an unsigned short. returns 0 on success.
150
/* converts an ASCIIZ string into an unsigned short. returns 0 on success.
148
 * on error, result will contain all valid digits that were read until
151
 * on error, result will contain all valid digits that were read until
149
 * error occurred (0 on overflow or if parsing failed immediately) */
152
 * error occurred (0 on overflow or if parsing failed immediately) */
150
int atous(unsigned short *r, const char *s);
153
int atous(unsigned short *r, const char *s);
151
 
154
 
152
/* appends a backslash if path is a directory
155
/* appends a backslash if path is a directory
153
 * returns the (possibly updated) length of path */
156
 * returns the (possibly updated) length of path */
154
unsigned short path_appendbkslash_if_dir(char *path);
157
unsigned short path_appendbkslash_if_dir(char *path);
155
 
158
 
156
/* get current path drive d (A=1, B=2, etc - 0 is "current drive")
159
/* get current path drive d (A=1, B=2, etc - 0 is "current drive")
157
 * returns 0 on success, doserr otherwise */
160
 * returns 0 on success, doserr otherwise */
158
unsigned short curpathfordrv(char *buff, unsigned char d);
161
unsigned short curpathfordrv(char *buff, unsigned char d);
159
 
162
 
160
/* fills a nls_patterns struct with current NLS patterns, returns 0 on success, DOS errcode otherwise */
163
/* fills a nls_patterns struct with current NLS patterns, returns 0 on success, DOS errcode otherwise */
161
unsigned short nls_getpatterns(struct nls_patterns *p);
164
unsigned short nls_getpatterns(struct nls_patterns *p);
162
 
165
 
163
/* computes a formatted date based on NLS patterns found in p
166
/* computes a formatted date based on NLS patterns found in p
164
 * returns length of result */
167
 * returns length of result */
165
unsigned short nls_format_date(char *s, unsigned short yr, unsigned char mo, unsigned char dy, const struct nls_patterns *p);
168
unsigned short nls_format_date(char *s, unsigned short yr, unsigned char mo, unsigned char dy, const struct nls_patterns *p);
166
 
169
 
167
/* computes a formatted time based on NLS patterns found in p, sc are ignored if set 0xff
170
/* computes a formatted time based on NLS patterns found in p, sc are ignored if set 0xff
168
 * returns length of result */
171
 * returns length of result */
169
unsigned short nls_format_time(char *s, unsigned char ho, unsigned char mn, unsigned char sc, const struct nls_patterns *p);
172
unsigned short nls_format_time(char *s, unsigned char ho, unsigned char mn, unsigned char sc, const struct nls_patterns *p);
170
 
173
 
171
/* computes a formatted integer number based on NLS patterns found in p
174
/* computes a formatted integer number based on NLS patterns found in p
172
 * returns length of result */
175
 * returns length of result */
173
unsigned short nls_format_number(char *s, unsigned long num, const struct nls_patterns *p);
176
unsigned short nls_format_number(char *s, unsigned long num, const struct nls_patterns *p);
174
 
177
 
175
/* reload nls ressources from svarcom.lng into langblock */
178
/* reload nls ressources from svarcom.lng into langblock */
176
void nls_langreload(char *buff, unsigned short env);
179
void nls_langreload(char *buff, unsigned short env);
177
 
180
 
178
#endif
181
#endif
179
 
182