1cdk_misc(3) Library Functions Manual cdk_misc(3)
2
6 cdk_misc - Curses Development Kit Miscellaneous Routines
7
9 cc [ flag ... ] file ... -lcdk [ library ... ]
10 #include <cdk.h>
12 void Beep(void);
14 unsigned CDKallocStrings(
16 char ***list/,
17 char *item/,
18 unsigned length/,
19 unsigned used/);
20 unsigned CDKcountStrings (
22 CDK_CONST char **list);
23 void CDKfreeChtypes(
25 chtype **list);
26 void CDKfreeStrings (
28 char **list);
29 char ** CDKsplitString (
31 const char *string,
32 int splitChar);
33 char * baseName (
35 char *string);
36 int ceilCDK( doublevalue);
38 int chlen ( const chtype *string);
40 void chstrncpy(
42 char *dest,
43 const chtype *src,
44 int maxcount);
45 char *chtype2Char (
47 const chtype *string);
48 void cleanChar (
50 char *string,
51 int length,
52 char character);
53 void cleanChtype (
55 chtype *string,
56 int length,
57 chtype character);
58 int cmpStrChstr(
60 const char *str,
61 const chtype *chstr);
62 char *copyChar (
64 const char *string);
65 char **copyCharList (
67 const char **list);
68 chtype *copyChtype (
70 const chtype *string);
71 chtype **copyChtypeList (
73 const chtype **list);
74 char *dirName (
76 char *filename);
77 int floorCDK( double value);
79 void freeChar (
81 char *string);
82 void freeCharList (
84 char **list,
85 unsigned size);
86 void freeChtype (
88 chtype *string);
89 void freeChtypeList ("
91 chtype **list,
92 unsigned size);
93 int intlen ( int value);
95 int lenCharList (
97 const char **list);
98 int lenChtypeList (
100 const chtype **list);
101 int mode2Char (
103 char *string,
104 mode_t fileMode);
105 int searchList (
107 CDK_CONST char * CDK_CONST *list,
108 int listSize,
109 const char *pattern);
110 void sortList (
112 CDK_CONST char **list,
113 int length);
114
116 These are miscellaneous functions which may be useful with the Cdk wid‐
117 get set.
118
120 Beep makes an audible beep. The standard curses beep() does not flush
121 the stream, so it will only beep until a force is made. This
122 forces a flush after issuing the beep command.
123 CDKallocStrings
125 Add a new string item to a list. Keep a null pointer on the end
126 so one may use CDKfreeStrings() to deallocate the whole list. The
127 caller is responsible for updating the length of the list. The
128 return value is the updated number of chars used.
129 CDKcountStrings
131 Count the number of items in a null-terminated list of character
132 strings. Return the count.
133 CDKfreeChtypes
135 Free a list of chtype-strings which is terminated by a null
136 pointer.
137 CDKfreeStrings
139 Free a list of character strings which is terminated by a null
140 pointer. Also free list itself.
141 CDKsplitString
143 split the string at each occurrence of separator, returning a
144 pointer to a dynamically allocated array of the pieces. The orig‐
145 inal string is unmodified. The caller is responsible for freeing
146 the result.
147 baseName
149 returns a pointer to the first character of the filename in the
150 given pathname. The result should be freed by the caller.
151 ceilCDK
153 Return an integer like the math library ceil(), which returns a
154 double.
155 chlen
157 returns the length of the (null-terminated) string of chtype's.
158 chstrncpy
160 Extract the characters from a null-terminated array of chtype's
161 src. The size of the destination dest is given in maxcount.
162 chtype2Char
164 Extract the characters from a null-terminated array of chtype's
165 string. A dynamically allocated string is returned. The caller
166 is responsible for freeing the result.
167 cleanChar
169 is analogous to memset. Set the characters in string to the given
170 character. The length of string is given by length. character
171 which will be written.
172 cleanChtype
174 is analogous to memset. Set the chtype's in string to the given
175 character. The length of string is given by length.
176 cmpStrChstr
178 Compare a char string str to a chtype string chstr. Return -1, 0
179 or 1 according to whether str is less than, equal to to greater
180 than chstr.
181 copyChar
183 copies the string passed in. Unlike strdup this checks to see if
184 the string is NULL before copying.
185 copyCharList
187 copies the given list.
188 copyChtype
190 function copies the string passed in, analogous to copyChar, but
191 for chtype strings.
192 copyChtypeList
194 copies the given list.
195 dirName
197 Returns the directory for the given filename, i.e., the part
198 before the * last slash. The return value should be freed by the
199 caller.
200 floorCDK
202 Return an integer like the math function floor(), which returns a
203 double.
204 freeChar
206 is a wrapper for free. It checks to see if the string is NULL
207 before trying to free the string.
208 freeCharList
210 Free the memory used by the given list of strings. The number of
211 strings to free is given by size.
212 freeChtype
214 is a wrapper for free, like freeChar.
215 freeChtypeList
217 Free the memory used by the given list of chtype strings. The
218 number of strings to free is given by size.
219 intlen
221 returns the length of an integer, i.e., the number of characters
222 needed to represent it.
223 lenCharList
225 returns the length of the given list.
226 lenChtypeList
228 returns the length of the given list.
229 mode2Char
231 Given a file protection mode fileMode, store a printable version
232 of the permissions in string, formatted as if by "ls -l"). Return
233 the corresponding permissions data, i.e., ignoring the file-type
234 bits.
235 searchList
237 Search the given list of listSize strings for a subset of a word
238 pattern in the given list. Return the index in the list if it is
239 found, or -1 if not found.
240 sortList
242 performs a quick sort of the given list. This is a wrapper for
243 qsort, used to sort the list of strings. The number of strings in
244 list is given by length. The list is sorted alphabetically in
245 increasing order.
246
248 cdk(3), cdk_screen(3), cdk_display(3), cdk_binding(3), cdk_util(3)
249 cdk_misc(3)