1 /* $NetBSD: history.c,v 1.46 2011/11/18 20:39:18 christos Exp $ */
4 * Copyright (c) 1992, 1993
5 * The Regents of the University of California. All rights reserved.
7 * This code is derived from software contributed to Berkeley by
8 * Christos Zoulas of Cornell University.
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. Neither the name of the University nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 #if !defined(lint) && !defined(SCCSID)
38 static char sccsid
[] = "@(#)history.c 8.1 (Berkeley) 6/4/93";
40 __RCSID("$NetBSD: history.c,v 1.46 2011/11/18 20:39:18 christos Exp $");
42 #endif /* not lint && not SCCSID */
45 * hist.c: TYPE(History) access functions
53 static const char hist_cookie
[] = "_HiStOrY_V2_\n";
58 typedef int (*history_gfun_t
)(void *, TYPE(HistEvent
) *);
59 typedef int (*history_efun_t
)(void *, TYPE(HistEvent
) *, const Char
*);
60 typedef void (*history_vfun_t
)(void *, TYPE(HistEvent
) *);
61 typedef int (*history_sfun_t
)(void *, TYPE(HistEvent
) *, const int);
63 struct TYPE(history
) {
64 void *h_ref
; /* Argument for history fcns */
65 int h_ent
; /* Last entry point for history */
66 history_gfun_t h_first
; /* Get the first element */
67 history_gfun_t h_next
; /* Get the next element */
68 history_gfun_t h_last
; /* Get the last element */
69 history_gfun_t h_prev
; /* Get the previous element */
70 history_gfun_t h_curr
; /* Get the current element */
71 history_sfun_t h_set
; /* Set the current element */
72 history_sfun_t h_del
; /* Set the given element */
73 history_vfun_t h_clear
; /* Clear the history list */
74 history_efun_t h_enter
; /* Add an element */
75 history_efun_t h_add
; /* Append to an element */
78 #define HNEXT(h, ev) (*(h)->h_next)((h)->h_ref, ev)
79 #define HFIRST(h, ev) (*(h)->h_first)((h)->h_ref, ev)
80 #define HPREV(h, ev) (*(h)->h_prev)((h)->h_ref, ev)
81 #define HLAST(h, ev) (*(h)->h_last)((h)->h_ref, ev)
82 #define HCURR(h, ev) (*(h)->h_curr)((h)->h_ref, ev)
83 #define HSET(h, ev, n) (*(h)->h_set)((h)->h_ref, ev, n)
84 #define HCLEAR(h, ev) (*(h)->h_clear)((h)->h_ref, ev)
85 #define HENTER(h, ev, str) (*(h)->h_enter)((h)->h_ref, ev, str)
86 #define HADD(h, ev, str) (*(h)->h_add)((h)->h_ref, ev, str)
87 #define HDEL(h, ev, n) (*(h)->h_del)((h)->h_ref, ev, n)
89 #define h_strdup(a) Strdup(a)
90 #define h_malloc(a) malloc(a)
91 #define h_realloc(a, b) realloc((a), (b))
92 #define h_free(a) free(a)
101 private int history_setsize(TYPE(History
) *, TYPE(HistEvent
) *, int);
102 private int history_getsize(TYPE(History
) *, TYPE(HistEvent
) *);
103 private int history_setunique(TYPE(History
) *, TYPE(HistEvent
) *, int);
104 private int history_getunique(TYPE(History
) *, TYPE(HistEvent
) *);
105 private int history_set_fun(TYPE(History
) *, TYPE(History
) *);
106 private int history_load(TYPE(History
) *, const char *);
107 private int history_save(TYPE(History
) *, const char *);
108 private int history_prev_event(TYPE(History
) *, TYPE(HistEvent
) *, int);
109 private int history_next_event(TYPE(History
) *, TYPE(HistEvent
) *, int);
110 private int history_next_string(TYPE(History
) *, TYPE(HistEvent
) *, const Char
*);
111 private int history_prev_string(TYPE(History
) *, TYPE(HistEvent
) *, const Char
*);
114 /***********************************************************************/
117 * Builtin- history implementation
119 typedef struct hentry_t
{
120 TYPE(HistEvent
) ev
; /* What we return */
121 void *data
; /* data */
122 struct hentry_t
*next
; /* Next entry */
123 struct hentry_t
*prev
; /* Previous entry */
126 typedef struct history_t
{
127 hentry_t list
; /* Fake list header element */
128 hentry_t
*cursor
; /* Current element in the list */
129 int max
; /* Maximum number of events */
130 int cur
; /* Current number of events */
131 int eventid
; /* For generation of unique event id */
132 int flags
; /* TYPE(History) flags */
133 #define H_UNIQUE 1 /* Store only unique elements */
136 private int history_def_next(void *, TYPE(HistEvent
) *);
137 private int history_def_first(void *, TYPE(HistEvent
) *);
138 private int history_def_prev(void *, TYPE(HistEvent
) *);
139 private int history_def_last(void *, TYPE(HistEvent
) *);
140 private int history_def_curr(void *, TYPE(HistEvent
) *);
141 private int history_def_set(void *, TYPE(HistEvent
) *, const int);
142 private void history_def_clear(void *, TYPE(HistEvent
) *);
143 private int history_def_enter(void *, TYPE(HistEvent
) *, const Char
*);
144 private int history_def_add(void *, TYPE(HistEvent
) *, const Char
*);
145 private int history_def_del(void *, TYPE(HistEvent
) *, const int);
147 private int history_def_init(void **, TYPE(HistEvent
) *, int);
148 private int history_def_insert(history_t
*, TYPE(HistEvent
) *, const Char
*);
149 private void history_def_delete(history_t
*, TYPE(HistEvent
) *, hentry_t
*);
151 private int history_deldata_nth(history_t
*, TYPE(HistEvent
) *, int, void **);
152 private int history_set_nth(void *, TYPE(HistEvent
) *, int);
154 #define history_def_setsize(p, num)(void) (((history_t *)p)->max = (num))
155 #define history_def_getsize(p) (((history_t *)p)->cur)
156 #define history_def_getunique(p) (((((history_t *)p)->flags) & H_UNIQUE) != 0)
157 #define history_def_setunique(p, uni) \
159 (((history_t *)p)->flags) |= H_UNIQUE; \
161 (((history_t *)p)->flags) &= ~H_UNIQUE
163 #define he_strerror(code) he_errlist[code]
164 #define he_seterrev(evp, code) {\
166 evp->str = he_strerror(code);\
170 static const Char
*const he_errlist
[] = {
172 STR("unknown error"),
173 STR("malloc() failed"),
174 STR("first event not found"),
175 STR("last event not found"),
177 STR("no next event"),
178 STR("no previous event"),
179 STR("current event is invalid"),
180 STR("event not found"),
181 STR("can't read history from file"),
182 STR("can't write history"),
183 STR("required parameter(s) not supplied"),
184 STR("history size negative"),
185 STR("function not allowed with other history-functions-set the default"),
186 STR("bad parameters")
190 #define _HE_UNKNOWN 1
191 #define _HE_MALLOC_FAILED 2
192 #define _HE_FIRST_NOTFOUND 3
193 #define _HE_LAST_NOTFOUND 4
194 #define _HE_EMPTY_LIST 5
195 #define _HE_END_REACHED 6
196 #define _HE_START_REACHED 7
197 #define _HE_CURR_INVALID 8
198 #define _HE_NOT_FOUND 9
199 #define _HE_HIST_READ 10
200 #define _HE_HIST_WRITE 11
201 #define _HE_PARAM_MISSING 12
202 #define _HE_SIZE_NEGATIVE 13
203 #define _HE_NOT_ALLOWED 14
204 #define _HE_BAD_PARAM 15
206 /* history_def_first():
207 * Default function to return the first event in the history.
210 history_def_first(void *p
, TYPE(HistEvent
) *ev
)
212 history_t
*h
= (history_t
*) p
;
214 h
->cursor
= h
->list
.next
;
215 if (h
->cursor
!= &h
->list
)
218 he_seterrev(ev
, _HE_FIRST_NOTFOUND
);
226 /* history_def_last():
227 * Default function to return the last event in the history.
230 history_def_last(void *p
, TYPE(HistEvent
) *ev
)
232 history_t
*h
= (history_t
*) p
;
234 h
->cursor
= h
->list
.prev
;
235 if (h
->cursor
!= &h
->list
)
238 he_seterrev(ev
, _HE_LAST_NOTFOUND
);
246 /* history_def_next():
247 * Default function to return the next event in the history.
250 history_def_next(void *p
, TYPE(HistEvent
) *ev
)
252 history_t
*h
= (history_t
*) p
;
254 if (h
->cursor
== &h
->list
) {
255 he_seterrev(ev
, _HE_EMPTY_LIST
);
259 if (h
->cursor
->next
== &h
->list
) {
260 he_seterrev(ev
, _HE_END_REACHED
);
264 h
->cursor
= h
->cursor
->next
;
271 /* history_def_prev():
272 * Default function to return the previous event in the history.
275 history_def_prev(void *p
, TYPE(HistEvent
) *ev
)
277 history_t
*h
= (history_t
*) p
;
279 if (h
->cursor
== &h
->list
) {
281 (h
->cur
> 0) ? _HE_END_REACHED
: _HE_EMPTY_LIST
);
285 if (h
->cursor
->prev
== &h
->list
) {
286 he_seterrev(ev
, _HE_START_REACHED
);
290 h
->cursor
= h
->cursor
->prev
;
297 /* history_def_curr():
298 * Default function to return the current event in the history.
301 history_def_curr(void *p
, TYPE(HistEvent
) *ev
)
303 history_t
*h
= (history_t
*) p
;
305 if (h
->cursor
!= &h
->list
)
309 (h
->cur
> 0) ? _HE_CURR_INVALID
: _HE_EMPTY_LIST
);
317 /* history_def_set():
318 * Default function to set the current event in the history to the
322 history_def_set(void *p
, TYPE(HistEvent
) *ev
, const int n
)
324 history_t
*h
= (history_t
*) p
;
327 he_seterrev(ev
, _HE_EMPTY_LIST
);
330 if (h
->cursor
== &h
->list
|| h
->cursor
->ev
.num
!= n
) {
331 for (h
->cursor
= h
->list
.next
; h
->cursor
!= &h
->list
;
332 h
->cursor
= h
->cursor
->next
)
333 if (h
->cursor
->ev
.num
== n
)
336 if (h
->cursor
== &h
->list
) {
337 he_seterrev(ev
, _HE_NOT_FOUND
);
344 /* history_set_nth():
345 * Default function to set the current event in the history to the
349 history_set_nth(void *p
, TYPE(HistEvent
) *ev
, int n
)
351 history_t
*h
= (history_t
*) p
;
354 he_seterrev(ev
, _HE_EMPTY_LIST
);
357 for (h
->cursor
= h
->list
.prev
; h
->cursor
!= &h
->list
;
358 h
->cursor
= h
->cursor
->prev
)
361 if (h
->cursor
== &h
->list
) {
362 he_seterrev(ev
, _HE_NOT_FOUND
);
369 /* history_def_add():
370 * Append string to element
373 history_def_add(void *p
, TYPE(HistEvent
) *ev
, const Char
*str
)
375 history_t
*h
= (history_t
*) p
;
378 HistEventPrivate
*evp
= (void *)&h
->cursor
->ev
;
380 if (h
->cursor
== &h
->list
)
381 return history_def_enter(p
, ev
, str
);
382 len
= Strlen(evp
->str
) + Strlen(str
) + 1;
383 s
= h_malloc(len
* sizeof(*s
));
385 he_seterrev(ev
, _HE_MALLOC_FAILED
);
388 (void) Strncpy(s
, h
->cursor
->ev
.str
, len
);
390 (void) Strncat(s
, str
, len
- Strlen(s
) - 1);
399 history_deldata_nth(history_t
*h
, TYPE(HistEvent
) *ev
,
400 int num
, void **data
)
402 if (history_set_nth(h
, ev
, num
) != 0)
404 /* magic value to skip delete (just set to n-th history) */
405 if (data
== (void **)-1)
407 ev
->str
= Strdup(h
->cursor
->ev
.str
);
408 ev
->num
= h
->cursor
->ev
.num
;
410 *data
= h
->cursor
->data
;
411 history_def_delete(h
, ev
, h
->cursor
);
416 /* history_def_del():
417 * Delete element hp of the h list
421 history_def_del(void *p
, TYPE(HistEvent
) *ev
__attribute__((__unused__
)),
424 history_t
*h
= (history_t
*) p
;
425 if (history_def_set(h
, ev
, num
) != 0)
427 ev
->str
= Strdup(h
->cursor
->ev
.str
);
428 ev
->num
= h
->cursor
->ev
.num
;
429 history_def_delete(h
, ev
, h
->cursor
);
434 /* history_def_delete():
435 * Delete element hp of the h list
439 history_def_delete(history_t
*h
,
440 TYPE(HistEvent
) *ev
__attribute__((__unused__
)), hentry_t
*hp
)
442 HistEventPrivate
*evp
= (void *)&hp
->ev
;
445 if (h
->cursor
== hp
) {
446 h
->cursor
= hp
->prev
;
447 if (h
->cursor
== &h
->list
)
448 h
->cursor
= hp
->next
;
450 hp
->prev
->next
= hp
->next
;
451 hp
->next
->prev
= hp
->prev
;
458 /* history_def_insert():
459 * Insert element with string str in the h list
462 history_def_insert(history_t
*h
, TYPE(HistEvent
) *ev
, const Char
*str
)
466 c
= h_malloc(sizeof(*c
));
469 if ((c
->ev
.str
= h_strdup(str
)) == NULL
) {
474 c
->ev
.num
= ++h
->eventid
;
475 c
->next
= h
->list
.next
;
477 h
->list
.next
->prev
= c
;
485 he_seterrev(ev
, _HE_MALLOC_FAILED
);
490 /* history_def_enter():
491 * Default function to enter an item in the history
494 history_def_enter(void *p
, TYPE(HistEvent
) *ev
, const Char
*str
)
496 history_t
*h
= (history_t
*) p
;
498 if ((h
->flags
& H_UNIQUE
) != 0 && h
->list
.next
!= &h
->list
&&
499 Strcmp(h
->list
.next
->ev
.str
, str
) == 0)
502 if (history_def_insert(h
, ev
, str
) == -1)
503 return -1; /* error, keep error message */
506 * Always keep at least one entry.
507 * This way we don't have to check for the empty list.
509 while (h
->cur
> h
->max
&& h
->cur
> 0)
510 history_def_delete(h
, ev
, h
->list
.prev
);
516 /* history_def_init():
517 * Default history initialization function
521 history_def_init(void **p
, TYPE(HistEvent
) *ev
__attribute__((__unused__
)), int n
)
523 history_t
*h
= (history_t
*) h_malloc(sizeof(*h
));
532 h
->list
.next
= h
->list
.prev
= &h
->list
;
533 h
->list
.ev
.str
= NULL
;
535 h
->cursor
= &h
->list
;
542 /* history_def_clear():
543 * Default history cleanup function
546 history_def_clear(void *p
, TYPE(HistEvent
) *ev
)
548 history_t
*h
= (history_t
*) p
;
550 while (h
->list
.prev
!= &h
->list
)
551 history_def_delete(h
, ev
, h
->list
.prev
);
552 h
->cursor
= &h
->list
;
560 /************************************************************************/
563 * Initialization function.
565 public TYPE(History
) *
566 FUN(history
,init
)(void)
569 TYPE(History
) *h
= (TYPE(History
) *) h_malloc(sizeof(*h
));
573 if (history_def_init(&h
->h_ref
, &ev
, 0) == -1) {
578 h
->h_next
= history_def_next
;
579 h
->h_first
= history_def_first
;
580 h
->h_last
= history_def_last
;
581 h
->h_prev
= history_def_prev
;
582 h
->h_curr
= history_def_curr
;
583 h
->h_set
= history_def_set
;
584 h
->h_clear
= history_def_clear
;
585 h
->h_enter
= history_def_enter
;
586 h
->h_add
= history_def_add
;
587 h
->h_del
= history_def_del
;
597 FUN(history
,end
)(TYPE(History
) *h
)
601 if (h
->h_next
== history_def_next
)
602 history_def_clear(h
->h_ref
, &ev
);
609 /* history_setsize():
610 * Set history number of events
613 history_setsize(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
)
616 if (h
->h_next
!= history_def_next
) {
617 he_seterrev(ev
, _HE_NOT_ALLOWED
);
621 he_seterrev(ev
, _HE_BAD_PARAM
);
624 history_def_setsize(h
->h_ref
, num
);
629 /* history_getsize():
630 * Get number of events currently in history
633 history_getsize(TYPE(History
) *h
, TYPE(HistEvent
) *ev
)
635 if (h
->h_next
!= history_def_next
) {
636 he_seterrev(ev
, _HE_NOT_ALLOWED
);
639 ev
->num
= history_def_getsize(h
->h_ref
);
641 he_seterrev(ev
, _HE_SIZE_NEGATIVE
);
648 /* history_setunique():
649 * Set if adjacent equal events should not be entered in history.
652 history_setunique(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int uni
)
655 if (h
->h_next
!= history_def_next
) {
656 he_seterrev(ev
, _HE_NOT_ALLOWED
);
659 history_def_setunique(h
->h_ref
, uni
);
664 /* history_getunique():
665 * Get if adjacent equal events should not be entered in history.
668 history_getunique(TYPE(History
) *h
, TYPE(HistEvent
) *ev
)
670 if (h
->h_next
!= history_def_next
) {
671 he_seterrev(ev
, _HE_NOT_ALLOWED
);
674 ev
->num
= history_def_getunique(h
->h_ref
);
679 /* history_set_fun():
680 * Set history functions
683 history_set_fun(TYPE(History
) *h
, TYPE(History
) *nh
)
687 if (nh
->h_first
== NULL
|| nh
->h_next
== NULL
|| nh
->h_last
== NULL
||
688 nh
->h_prev
== NULL
|| nh
->h_curr
== NULL
|| nh
->h_set
== NULL
||
689 nh
->h_enter
== NULL
|| nh
->h_add
== NULL
|| nh
->h_clear
== NULL
||
690 nh
->h_del
== NULL
|| nh
->h_ref
== NULL
) {
691 if (h
->h_next
!= history_def_next
) {
692 if (history_def_init(&h
->h_ref
, &ev
, 0) == -1)
694 h
->h_first
= history_def_first
;
695 h
->h_next
= history_def_next
;
696 h
->h_last
= history_def_last
;
697 h
->h_prev
= history_def_prev
;
698 h
->h_curr
= history_def_curr
;
699 h
->h_set
= history_def_set
;
700 h
->h_clear
= history_def_clear
;
701 h
->h_enter
= history_def_enter
;
702 h
->h_add
= history_def_add
;
703 h
->h_del
= history_def_del
;
707 if (h
->h_next
== history_def_next
)
708 history_def_clear(h
->h_ref
, &ev
);
711 h
->h_first
= nh
->h_first
;
712 h
->h_next
= nh
->h_next
;
713 h
->h_last
= nh
->h_last
;
714 h
->h_prev
= nh
->h_prev
;
715 h
->h_curr
= nh
->h_curr
;
716 h
->h_set
= nh
->h_set
;
717 h
->h_clear
= nh
->h_clear
;
718 h
->h_enter
= nh
->h_enter
;
719 h
->h_add
= nh
->h_add
;
720 h
->h_del
= nh
->h_del
;
727 * TYPE(History) load function
730 history_load(TYPE(History
) *h
, const char *fname
)
739 static ct_buffer_t conv
;
742 if ((fp
= fopen(fname
, "r")) == NULL
)
745 if ((line
= fgetln(fp
, &sz
)) == NULL
)
748 if (strncmp(line
, hist_cookie
, sz
) != 0)
751 ptr
= h_malloc((max_size
= 1024) * sizeof(*ptr
));
754 for (i
= 0; (line
= fgetln(fp
, &sz
)) != NULL
; i
++) {
757 if (sz
!= 0 && line
[sz
- 1] == '\n')
764 max_size
= (sz
+ 1024) & (size_t)~1023;
765 nptr
= h_realloc(ptr
, max_size
* sizeof(*ptr
));
772 (void) strunvis(ptr
, line
);
774 if (HENTER(h
, &ev
, ct_decode_string(ptr
, &conv
)) == -1) {
788 * TYPE(History) save function
791 history_save(TYPE(History
) *h
, const char *fname
)
796 size_t len
, max_size
;
800 static ct_buffer_t conv
;
803 if ((fp
= fopen(fname
, "w")) == NULL
)
806 if (fchmod(fileno(fp
), S_IRUSR
|S_IWUSR
) == -1)
808 if (fputs(hist_cookie
, fp
) == EOF
)
810 ptr
= h_malloc((max_size
= 1024) * sizeof(*ptr
));
813 for (i
= 0, retval
= HLAST(h
, &ev
);
815 retval
= HPREV(h
, &ev
), i
++) {
816 str
= ct_encode_string(ev
.str
, &conv
);
817 len
= strlen(str
) * 4;
818 if (len
>= max_size
) {
820 max_size
= (len
+ 1024) & (size_t)~1023;
821 nptr
= h_realloc(ptr
, max_size
* sizeof(*ptr
));
828 (void) strvis(ptr
, str
, VIS_WHITE
);
829 (void) fprintf(fp
, "%s\n", ptr
);
839 /* history_prev_event():
840 * Find the previous event, with number given
843 history_prev_event(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
)
847 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HPREV(h
, ev
))
851 he_seterrev(ev
, _HE_NOT_FOUND
);
857 history_next_evdata(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
, void **d
)
861 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HPREV(h
, ev
))
862 if (ev
->num
== num
) {
864 *d
= ((history_t
*)h
->h_ref
)->cursor
->data
;
868 he_seterrev(ev
, _HE_NOT_FOUND
);
873 /* history_next_event():
874 * Find the next event, with number given
877 history_next_event(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
)
881 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HNEXT(h
, ev
))
885 he_seterrev(ev
, _HE_NOT_FOUND
);
890 /* history_prev_string():
891 * Find the previous event beginning with string
894 history_prev_string(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, const Char
*str
)
896 size_t len
= Strlen(str
);
899 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HNEXT(h
, ev
))
900 if (Strncmp(str
, ev
->str
, len
) == 0)
903 he_seterrev(ev
, _HE_NOT_FOUND
);
908 /* history_next_string():
909 * Find the next event beginning with string
912 history_next_string(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, const Char
*str
)
914 size_t len
= Strlen(str
);
917 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HPREV(h
, ev
))
918 if (Strncmp(str
, ev
->str
, len
) == 0)
921 he_seterrev(ev
, _HE_NOT_FOUND
);
927 * User interface to history functions.
930 FUNW(history
)(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int fun
, ...)
938 he_seterrev(ev
, _HE_OK
);
942 retval
= history_getsize(h
, ev
);
946 retval
= history_setsize(h
, ev
, va_arg(va
, int));
950 retval
= history_getunique(h
, ev
);
954 retval
= history_setunique(h
, ev
, va_arg(va
, int));
958 str
= va_arg(va
, const Char
*);
959 retval
= HADD(h
, ev
, str
);
963 retval
= HDEL(h
, ev
, va_arg(va
, const int));
967 str
= va_arg(va
, const Char
*);
968 if ((retval
= HENTER(h
, ev
, str
)) != -1)
973 str
= va_arg(va
, const Char
*);
974 if ((retval
= HSET(h
, ev
, h
->h_ent
)) != -1)
975 retval
= HADD(h
, ev
, str
);
979 retval
= HFIRST(h
, ev
);
983 retval
= HNEXT(h
, ev
);
987 retval
= HLAST(h
, ev
);
991 retval
= HPREV(h
, ev
);
995 retval
= HCURR(h
, ev
);
999 retval
= HSET(h
, ev
, va_arg(va
, const int));
1008 retval
= history_load(h
, va_arg(va
, const char *));
1010 he_seterrev(ev
, _HE_HIST_READ
);
1014 retval
= history_save(h
, va_arg(va
, const char *));
1016 he_seterrev(ev
, _HE_HIST_WRITE
);
1020 retval
= history_prev_event(h
, ev
, va_arg(va
, int));
1024 retval
= history_next_event(h
, ev
, va_arg(va
, int));
1028 retval
= history_prev_string(h
, ev
, va_arg(va
, const Char
*));
1032 retval
= history_next_string(h
, ev
, va_arg(va
, const Char
*));
1039 hf
.h_ref
= va_arg(va
, void *);
1041 hf
.h_first
= va_arg(va
, history_gfun_t
);
1042 hf
.h_next
= va_arg(va
, history_gfun_t
);
1043 hf
.h_last
= va_arg(va
, history_gfun_t
);
1044 hf
.h_prev
= va_arg(va
, history_gfun_t
);
1045 hf
.h_curr
= va_arg(va
, history_gfun_t
);
1046 hf
.h_set
= va_arg(va
, history_sfun_t
);
1047 hf
.h_clear
= va_arg(va
, history_vfun_t
);
1048 hf
.h_enter
= va_arg(va
, history_efun_t
);
1049 hf
.h_add
= va_arg(va
, history_efun_t
);
1050 hf
.h_del
= va_arg(va
, history_sfun_t
);
1052 if ((retval
= history_set_fun(h
, &hf
)) == -1)
1053 he_seterrev(ev
, _HE_PARAM_MISSING
);
1058 FUN(history
,end
)(h
);
1064 int num
= va_arg(va
, int);
1065 void **d
= va_arg(va
, void **);
1066 retval
= history_next_evdata(h
, ev
, num
, d
);
1072 int num
= va_arg(va
, int);
1073 void **d
= va_arg(va
, void **);
1074 retval
= history_deldata_nth((history_t
*)h
->h_ref
, ev
, num
, d
);
1078 case H_REPLACE
: /* only use after H_NEXT_EVDATA */
1080 const Char
*line
= va_arg(va
, const Char
*);
1081 void *d
= va_arg(va
, void *);
1083 if(!line
|| !(s
= Strdup(line
))) {
1087 ((history_t
*)h
->h_ref
)->cursor
->ev
.str
= s
;
1088 ((history_t
*)h
->h_ref
)->cursor
->data
= d
;
1095 he_seterrev(ev
, _HE_UNKNOWN
);