1 /* $NetBSD: history.c,v 1.36 2009/12/30 23:54:52 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.36 2009/12/30 23:54:52 christos Exp $");
42 #endif /* not lint && not SCCSID */
45 * hist.c: TYPE(History) access functions
57 static const char hist_cookie
[] = "_HiStOrY_V2_\n";
62 typedef int (*history_gfun_t
)(ptr_t
, TYPE(HistEvent
) *);
63 typedef int (*history_efun_t
)(ptr_t
, TYPE(HistEvent
) *, const Char
*);
64 typedef void (*history_vfun_t
)(ptr_t
, TYPE(HistEvent
) *);
65 typedef int (*history_sfun_t
)(ptr_t
, TYPE(HistEvent
) *, const int);
67 struct TYPE(history
) {
68 ptr_t h_ref
; /* Argument for history fcns */
69 int h_ent
; /* Last entry point for history */
70 history_gfun_t h_first
; /* Get the first element */
71 history_gfun_t h_next
; /* Get the next element */
72 history_gfun_t h_last
; /* Get the last element */
73 history_gfun_t h_prev
; /* Get the previous element */
74 history_gfun_t h_curr
; /* Get the current element */
75 history_sfun_t h_set
; /* Set the current element */
76 history_sfun_t h_del
; /* Set the given element */
77 history_vfun_t h_clear
; /* Clear the history list */
78 history_efun_t h_enter
; /* Add an element */
79 history_efun_t h_add
; /* Append to an element */
82 #define HNEXT(h, ev) (*(h)->h_next)((h)->h_ref, ev)
83 #define HFIRST(h, ev) (*(h)->h_first)((h)->h_ref, ev)
84 #define HPREV(h, ev) (*(h)->h_prev)((h)->h_ref, ev)
85 #define HLAST(h, ev) (*(h)->h_last)((h)->h_ref, ev)
86 #define HCURR(h, ev) (*(h)->h_curr)((h)->h_ref, ev)
87 #define HSET(h, ev, n) (*(h)->h_set)((h)->h_ref, ev, n)
88 #define HCLEAR(h, ev) (*(h)->h_clear)((h)->h_ref, ev)
89 #define HENTER(h, ev, str) (*(h)->h_enter)((h)->h_ref, ev, str)
90 #define HADD(h, ev, str) (*(h)->h_add)((h)->h_ref, ev, str)
91 #define HDEL(h, ev, n) (*(h)->h_del)((h)->h_ref, ev, n)
93 #define h_strdup(a) Strdup(a)
94 #define h_malloc(a) malloc(a)
95 #define h_realloc(a, b) realloc((a), (b))
96 #define h_free(a) free(a)
105 private int history_setsize(TYPE(History
) *, TYPE(HistEvent
) *, int);
106 private int history_getsize(TYPE(History
) *, TYPE(HistEvent
) *);
107 private int history_setunique(TYPE(History
) *, TYPE(HistEvent
) *, int);
108 private int history_getunique(TYPE(History
) *, TYPE(HistEvent
) *);
109 private int history_set_fun(TYPE(History
) *, TYPE(History
) *);
110 private int history_load(TYPE(History
) *, const char *);
111 private int history_save(TYPE(History
) *, const char *);
112 private int history_prev_event(TYPE(History
) *, TYPE(HistEvent
) *, int);
113 private int history_next_event(TYPE(History
) *, TYPE(HistEvent
) *, int);
114 private int history_next_string(TYPE(History
) *, TYPE(HistEvent
) *, const Char
*);
115 private int history_prev_string(TYPE(History
) *, TYPE(HistEvent
) *, const Char
*);
118 /***********************************************************************/
121 * Builtin- history implementation
123 typedef struct hentry_t
{
124 TYPE(HistEvent
) ev
; /* What we return */
125 void *data
; /* data */
126 struct hentry_t
*next
; /* Next entry */
127 struct hentry_t
*prev
; /* Previous entry */
130 typedef struct history_t
{
131 hentry_t list
; /* Fake list header element */
132 hentry_t
*cursor
; /* Current element in the list */
133 int max
; /* Maximum number of events */
134 int cur
; /* Current number of events */
135 int eventid
; /* For generation of unique event id */
136 int flags
; /* TYPE(History) flags */
137 #define H_UNIQUE 1 /* Store only unique elements */
140 private int history_def_next(ptr_t
, TYPE(HistEvent
) *);
141 private int history_def_first(ptr_t
, TYPE(HistEvent
) *);
142 private int history_def_prev(ptr_t
, TYPE(HistEvent
) *);
143 private int history_def_last(ptr_t
, TYPE(HistEvent
) *);
144 private int history_def_curr(ptr_t
, TYPE(HistEvent
) *);
145 private int history_def_set(ptr_t
, TYPE(HistEvent
) *, const int);
146 private void history_def_clear(ptr_t
, TYPE(HistEvent
) *);
147 private int history_def_enter(ptr_t
, TYPE(HistEvent
) *, const Char
*);
148 private int history_def_add(ptr_t
, TYPE(HistEvent
) *, const Char
*);
149 private int history_def_del(ptr_t
, TYPE(HistEvent
) *, const int);
151 private int history_def_init(ptr_t
*, TYPE(HistEvent
) *, int);
152 private int history_def_insert(history_t
*, TYPE(HistEvent
) *, const Char
*);
153 private void history_def_delete(history_t
*, TYPE(HistEvent
) *, hentry_t
*);
155 private int history_deldata_nth(history_t
*, TYPE(HistEvent
) *, int, void **);
156 private int history_set_nth(ptr_t
, TYPE(HistEvent
) *, int);
158 #define history_def_setsize(p, num)(void) (((history_t *)p)->max = (num))
159 #define history_def_getsize(p) (((history_t *)p)->cur)
160 #define history_def_getunique(p) (((((history_t *)p)->flags) & H_UNIQUE) != 0)
161 #define history_def_setunique(p, uni) \
163 (((history_t *)p)->flags) |= H_UNIQUE; \
165 (((history_t *)p)->flags) &= ~H_UNIQUE
167 #define he_strerror(code) he_errlist[code]
168 #define he_seterrev(evp, code) {\
170 evp->str = he_strerror(code);\
174 static const Char
*const he_errlist
[] = {
176 STR("unknown error"),
177 STR("malloc() failed"),
178 STR("first event not found"),
179 STR("last event not found"),
181 STR("no next event"),
182 STR("no previous event"),
183 STR("current event is invalid"),
184 STR("event not found"),
185 STR("can't read history from file"),
186 STR("can't write history"),
187 STR("required parameter(s) not supplied"),
188 STR("history size negative"),
189 STR("function not allowed with other history-functions-set the default"),
190 STR("bad parameters")
194 #define _HE_UNKNOWN 1
195 #define _HE_MALLOC_FAILED 2
196 #define _HE_FIRST_NOTFOUND 3
197 #define _HE_LAST_NOTFOUND 4
198 #define _HE_EMPTY_LIST 5
199 #define _HE_END_REACHED 6
200 #define _HE_START_REACHED 7
201 #define _HE_CURR_INVALID 8
202 #define _HE_NOT_FOUND 9
203 #define _HE_HIST_READ 10
204 #define _HE_HIST_WRITE 11
205 #define _HE_PARAM_MISSING 12
206 #define _HE_SIZE_NEGATIVE 13
207 #define _HE_NOT_ALLOWED 14
208 #define _HE_BAD_PARAM 15
210 /* history_def_first():
211 * Default function to return the first event in the history.
214 history_def_first(ptr_t p
, TYPE(HistEvent
) *ev
)
216 history_t
*h
= (history_t
*) p
;
218 h
->cursor
= h
->list
.next
;
219 if (h
->cursor
!= &h
->list
)
222 he_seterrev(ev
, _HE_FIRST_NOTFOUND
);
230 /* history_def_last():
231 * Default function to return the last event in the history.
234 history_def_last(ptr_t p
, TYPE(HistEvent
) *ev
)
236 history_t
*h
= (history_t
*) p
;
238 h
->cursor
= h
->list
.prev
;
239 if (h
->cursor
!= &h
->list
)
242 he_seterrev(ev
, _HE_LAST_NOTFOUND
);
250 /* history_def_next():
251 * Default function to return the next event in the history.
254 history_def_next(ptr_t p
, TYPE(HistEvent
) *ev
)
256 history_t
*h
= (history_t
*) p
;
258 if (h
->cursor
== &h
->list
) {
259 he_seterrev(ev
, _HE_EMPTY_LIST
);
263 if (h
->cursor
->next
== &h
->list
) {
264 he_seterrev(ev
, _HE_END_REACHED
);
268 h
->cursor
= h
->cursor
->next
;
275 /* history_def_prev():
276 * Default function to return the previous event in the history.
279 history_def_prev(ptr_t p
, TYPE(HistEvent
) *ev
)
281 history_t
*h
= (history_t
*) p
;
283 if (h
->cursor
== &h
->list
) {
285 (h
->cur
> 0) ? _HE_END_REACHED
: _HE_EMPTY_LIST
);
289 if (h
->cursor
->prev
== &h
->list
) {
290 he_seterrev(ev
, _HE_START_REACHED
);
294 h
->cursor
= h
->cursor
->prev
;
301 /* history_def_curr():
302 * Default function to return the current event in the history.
305 history_def_curr(ptr_t p
, TYPE(HistEvent
) *ev
)
307 history_t
*h
= (history_t
*) p
;
309 if (h
->cursor
!= &h
->list
)
313 (h
->cur
> 0) ? _HE_CURR_INVALID
: _HE_EMPTY_LIST
);
321 /* history_def_set():
322 * Default function to set the current event in the history to the
326 history_def_set(ptr_t p
, TYPE(HistEvent
) *ev
, const int n
)
328 history_t
*h
= (history_t
*) p
;
331 he_seterrev(ev
, _HE_EMPTY_LIST
);
334 if (h
->cursor
== &h
->list
|| h
->cursor
->ev
.num
!= n
) {
335 for (h
->cursor
= h
->list
.next
; h
->cursor
!= &h
->list
;
336 h
->cursor
= h
->cursor
->next
)
337 if (h
->cursor
->ev
.num
== n
)
340 if (h
->cursor
== &h
->list
) {
341 he_seterrev(ev
, _HE_NOT_FOUND
);
348 /* history_set_nth():
349 * Default function to set the current event in the history to the
353 history_set_nth(ptr_t p
, TYPE(HistEvent
) *ev
, int n
)
355 history_t
*h
= (history_t
*) p
;
358 he_seterrev(ev
, _HE_EMPTY_LIST
);
361 for (h
->cursor
= h
->list
.prev
; h
->cursor
!= &h
->list
;
362 h
->cursor
= h
->cursor
->prev
)
365 if (h
->cursor
== &h
->list
) {
366 he_seterrev(ev
, _HE_NOT_FOUND
);
373 /* history_def_add():
374 * Append string to element
377 history_def_add(ptr_t p
, TYPE(HistEvent
) *ev
, const Char
*str
)
379 history_t
*h
= (history_t
*) p
;
382 HistEventPrivate
*evp
= (void *)&h
->cursor
->ev
;
384 if (h
->cursor
== &h
->list
)
385 return (history_def_enter(p
, ev
, str
));
386 len
= Strlen(evp
->str
) + Strlen(str
) + 1;
387 s
= h_malloc(len
* sizeof(*s
));
389 he_seterrev(ev
, _HE_MALLOC_FAILED
);
392 (void) Strncpy(s
, h
->cursor
->ev
.str
, len
);
394 (void) Strncat(s
, str
, len
- Strlen(s
) - 1);
395 h_free((ptr_t
)evp
->str
);
403 history_deldata_nth(history_t
*h
, TYPE(HistEvent
) *ev
,
404 int num
, void **data
)
406 if (history_set_nth(h
, ev
, num
) != 0)
408 /* magic value to skip delete (just set to n-th history) */
409 if (data
== (void **)-1)
411 ev
->str
= Strdup(h
->cursor
->ev
.str
);
412 ev
->num
= h
->cursor
->ev
.num
;
414 *data
= h
->cursor
->data
;
415 history_def_delete(h
, ev
, h
->cursor
);
420 /* history_def_del():
421 * Delete element hp of the h list
425 history_def_del(ptr_t p
, TYPE(HistEvent
) *ev
__attribute__((__unused__
)),
428 history_t
*h
= (history_t
*) p
;
429 if (history_def_set(h
, ev
, num
) != 0)
431 ev
->str
= Strdup(h
->cursor
->ev
.str
);
432 ev
->num
= h
->cursor
->ev
.num
;
433 history_def_delete(h
, ev
, h
->cursor
);
438 /* history_def_delete():
439 * Delete element hp of the h list
443 history_def_delete(history_t
*h
,
444 TYPE(HistEvent
) *ev
__attribute__((__unused__
)), hentry_t
*hp
)
446 HistEventPrivate
*evp
= (void *)&hp
->ev
;
449 if (h
->cursor
== hp
) {
450 h
->cursor
= hp
->prev
;
451 if (h
->cursor
== &h
->list
)
452 h
->cursor
= hp
->next
;
454 hp
->prev
->next
= hp
->next
;
455 hp
->next
->prev
= hp
->prev
;
456 h_free((ptr_t
) evp
->str
);
462 /* history_def_insert():
463 * Insert element with string str in the h list
466 history_def_insert(history_t
*h
, TYPE(HistEvent
) *ev
, const Char
*str
)
469 h
->cursor
= (hentry_t
*) h_malloc(sizeof(hentry_t
));
470 if (h
->cursor
== NULL
)
472 if ((h
->cursor
->ev
.str
= h_strdup(str
)) == NULL
) {
473 h_free((ptr_t
)h
->cursor
);
476 h
->cursor
->data
= NULL
;
477 h
->cursor
->ev
.num
= ++h
->eventid
;
478 h
->cursor
->next
= h
->list
.next
;
479 h
->cursor
->prev
= &h
->list
;
480 h
->list
.next
->prev
= h
->cursor
;
481 h
->list
.next
= h
->cursor
;
487 he_seterrev(ev
, _HE_MALLOC_FAILED
);
492 /* history_def_enter():
493 * Default function to enter an item in the history
496 history_def_enter(ptr_t p
, TYPE(HistEvent
) *ev
, const Char
*str
)
498 history_t
*h
= (history_t
*) p
;
500 if ((h
->flags
& H_UNIQUE
) != 0 && h
->list
.next
!= &h
->list
&&
501 Strcmp(h
->list
.next
->ev
.str
, str
) == 0)
504 if (history_def_insert(h
, ev
, str
) == -1)
505 return (-1); /* error, keep error message */
508 * Always keep at least one entry.
509 * This way we don't have to check for the empty list.
511 while (h
->cur
> h
->max
&& h
->cur
> 0)
512 history_def_delete(h
, ev
, h
->list
.prev
);
518 /* history_def_init():
519 * Default history initialization function
523 history_def_init(ptr_t
*p
, TYPE(HistEvent
) *ev
__attribute__((__unused__
)), int n
)
525 history_t
*h
= (history_t
*) h_malloc(sizeof(history_t
));
534 h
->list
.next
= h
->list
.prev
= &h
->list
;
535 h
->list
.ev
.str
= NULL
;
537 h
->cursor
= &h
->list
;
544 /* history_def_clear():
545 * Default history cleanup function
548 history_def_clear(ptr_t p
, TYPE(HistEvent
) *ev
)
550 history_t
*h
= (history_t
*) p
;
552 while (h
->list
.prev
!= &h
->list
)
553 history_def_delete(h
, ev
, h
->list
.prev
);
561 /************************************************************************/
564 * Initialization function.
566 public TYPE(History
) *
567 FUN(history
,init
)(void)
570 TYPE(History
) *h
= (TYPE(History
) *) h_malloc(sizeof(TYPE(History
)));
574 if (history_def_init(&h
->h_ref
, &ev
, 0) == -1) {
579 h
->h_next
= history_def_next
;
580 h
->h_first
= history_def_first
;
581 h
->h_last
= history_def_last
;
582 h
->h_prev
= history_def_prev
;
583 h
->h_curr
= history_def_curr
;
584 h
->h_set
= history_def_set
;
585 h
->h_clear
= history_def_clear
;
586 h
->h_enter
= history_def_enter
;
587 h
->h_add
= history_def_add
;
588 h
->h_del
= history_def_del
;
598 FUN(history
,end
)(TYPE(History
) *h
)
602 if (h
->h_next
== history_def_next
)
603 history_def_clear(h
->h_ref
, &ev
);
610 /* history_setsize():
611 * Set history number of events
614 history_setsize(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
)
617 if (h
->h_next
!= history_def_next
) {
618 he_seterrev(ev
, _HE_NOT_ALLOWED
);
622 he_seterrev(ev
, _HE_BAD_PARAM
);
625 history_def_setsize(h
->h_ref
, num
);
630 /* history_getsize():
631 * Get number of events currently in history
634 history_getsize(TYPE(History
) *h
, TYPE(HistEvent
) *ev
)
636 if (h
->h_next
!= history_def_next
) {
637 he_seterrev(ev
, _HE_NOT_ALLOWED
);
640 ev
->num
= history_def_getsize(h
->h_ref
);
642 he_seterrev(ev
, _HE_SIZE_NEGATIVE
);
649 /* history_setunique():
650 * Set if adjacent equal events should not be entered in history.
653 history_setunique(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int uni
)
656 if (h
->h_next
!= history_def_next
) {
657 he_seterrev(ev
, _HE_NOT_ALLOWED
);
660 history_def_setunique(h
->h_ref
, uni
);
665 /* history_getunique():
666 * Get if adjacent equal events should not be entered in history.
669 history_getunique(TYPE(History
) *h
, TYPE(HistEvent
) *ev
)
671 if (h
->h_next
!= history_def_next
) {
672 he_seterrev(ev
, _HE_NOT_ALLOWED
);
675 ev
->num
= history_def_getunique(h
->h_ref
);
680 /* history_set_fun():
681 * Set history functions
684 history_set_fun(TYPE(History
) *h
, TYPE(History
) *nh
)
688 if (nh
->h_first
== NULL
|| nh
->h_next
== NULL
|| nh
->h_last
== NULL
||
689 nh
->h_prev
== NULL
|| nh
->h_curr
== NULL
|| nh
->h_set
== NULL
||
690 nh
->h_enter
== NULL
|| nh
->h_add
== NULL
|| nh
->h_clear
== NULL
||
691 nh
->h_del
== NULL
|| nh
->h_ref
== NULL
) {
692 if (h
->h_next
!= history_def_next
) {
693 history_def_init(&h
->h_ref
, &ev
, 0);
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);
754 for (i
= 0; (line
= fgetln(fp
, &sz
)) != NULL
; i
++) {
757 if (sz
!= 0 && line
[sz
- 1] == '\n')
764 max_size
= (sz
+ 1024) & ~1023;
765 nptr
= h_realloc(ptr
, max_size
);
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
;
799 static ct_buffer_t conv
;
802 if ((fp
= fopen(fname
, "w")) == NULL
)
805 if (fchmod(fileno(fp
), S_IRUSR
|S_IWUSR
) == -1)
807 if (fputs(hist_cookie
, fp
) == EOF
)
809 ptr
= h_malloc(max_size
= 1024);
812 for (i
= 0, retval
= HLAST(h
, &ev
);
814 retval
= HPREV(h
, &ev
), i
++) {
815 len
= Strlen(ev
.str
) * 4;
816 if (len
>= max_size
) {
818 max_size
= (len
+ 1024) & ~1023;
819 nptr
= h_realloc(ptr
, max_size
);
826 (void) strvis(ptr
, ct_encode_string(ev
.str
, &conv
), VIS_WHITE
);
827 (void) fprintf(fp
, "%s\n", ptr
);
837 /* history_prev_event():
838 * Find the previous event, with number given
841 history_prev_event(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
)
845 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HPREV(h
, ev
))
849 he_seterrev(ev
, _HE_NOT_FOUND
);
855 history_next_evdata(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
, void **d
)
859 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HPREV(h
, ev
))
862 *d
= ((history_t
*)h
->h_ref
)->cursor
->data
;
866 he_seterrev(ev
, _HE_NOT_FOUND
);
871 /* history_next_event():
872 * Find the next event, with number given
875 history_next_event(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int num
)
879 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HNEXT(h
, ev
))
883 he_seterrev(ev
, _HE_NOT_FOUND
);
888 /* history_prev_string():
889 * Find the previous event beginning with string
892 history_prev_string(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, const Char
*str
)
894 size_t len
= Strlen(str
);
897 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HNEXT(h
, ev
))
898 if (Strncmp(str
, ev
->str
, len
) == 0)
901 he_seterrev(ev
, _HE_NOT_FOUND
);
906 /* history_next_string():
907 * Find the next event beginning with string
910 history_next_string(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, const Char
*str
)
912 size_t len
= Strlen(str
);
915 for (retval
= HCURR(h
, ev
); retval
!= -1; retval
= HPREV(h
, ev
))
916 if (Strncmp(str
, ev
->str
, len
) == 0)
919 he_seterrev(ev
, _HE_NOT_FOUND
);
925 * User interface to history functions.
928 FUNW(history
)(TYPE(History
) *h
, TYPE(HistEvent
) *ev
, int fun
, ...)
936 he_seterrev(ev
, _HE_OK
);
940 retval
= history_getsize(h
, ev
);
944 retval
= history_setsize(h
, ev
, va_arg(va
, int));
948 retval
= history_getunique(h
, ev
);
952 retval
= history_setunique(h
, ev
, va_arg(va
, int));
956 str
= va_arg(va
, const Char
*);
957 retval
= HADD(h
, ev
, str
);
961 retval
= HDEL(h
, ev
, va_arg(va
, const int));
965 str
= va_arg(va
, const Char
*);
966 if ((retval
= HENTER(h
, ev
, str
)) != -1)
971 str
= va_arg(va
, const Char
*);
972 if ((retval
= HSET(h
, ev
, h
->h_ent
)) != -1)
973 retval
= HADD(h
, ev
, str
);
977 retval
= HFIRST(h
, ev
);
981 retval
= HNEXT(h
, ev
);
985 retval
= HLAST(h
, ev
);
989 retval
= HPREV(h
, ev
);
993 retval
= HCURR(h
, ev
);
997 retval
= HSET(h
, ev
, va_arg(va
, const int));
1006 retval
= history_load(h
, va_arg(va
, const char *));
1008 he_seterrev(ev
, _HE_HIST_READ
);
1012 retval
= history_save(h
, va_arg(va
, const char *));
1014 he_seterrev(ev
, _HE_HIST_WRITE
);
1018 retval
= history_prev_event(h
, ev
, va_arg(va
, int));
1022 retval
= history_next_event(h
, ev
, va_arg(va
, int));
1026 retval
= history_prev_string(h
, ev
, va_arg(va
, const Char
*));
1030 retval
= history_next_string(h
, ev
, va_arg(va
, const Char
*));
1037 hf
.h_ref
= va_arg(va
, ptr_t
);
1039 hf
.h_first
= va_arg(va
, history_gfun_t
);
1040 hf
.h_next
= va_arg(va
, history_gfun_t
);
1041 hf
.h_last
= va_arg(va
, history_gfun_t
);
1042 hf
.h_prev
= va_arg(va
, history_gfun_t
);
1043 hf
.h_curr
= va_arg(va
, history_gfun_t
);
1044 hf
.h_set
= va_arg(va
, history_sfun_t
);
1045 hf
.h_clear
= va_arg(va
, history_vfun_t
);
1046 hf
.h_enter
= va_arg(va
, history_efun_t
);
1047 hf
.h_add
= va_arg(va
, history_efun_t
);
1048 hf
.h_del
= va_arg(va
, history_sfun_t
);
1050 if ((retval
= history_set_fun(h
, &hf
)) == -1)
1051 he_seterrev(ev
, _HE_PARAM_MISSING
);
1056 FUN(history
,end
)(h
);
1062 int num
= va_arg(va
, int);
1063 void **d
= va_arg(va
, void **);
1064 retval
= history_next_evdata(h
, ev
, num
, d
);
1070 int num
= va_arg(va
, int);
1071 void **d
= va_arg(va
, void **);
1072 retval
= history_deldata_nth((history_t
*)h
->h_ref
, ev
, num
, d
);
1076 case H_REPLACE
: /* only use after H_NEXT_EVDATA */
1078 const Char
*line
= va_arg(va
, const Char
*);
1079 void *d
= va_arg(va
, void *);
1081 if(!line
|| !(s
= Strdup(line
))) {
1085 ((history_t
*)h
->h_ref
)->cursor
->ev
.str
= s
;
1086 ((history_t
*)h
->h_ref
)->cursor
->data
= d
;
1093 he_seterrev(ev
, _HE_UNKNOWN
);