Annotation of embedaddon/ntp/lib/isc/nls/msgcat.c, revision 1.1.1.1
1.1 misho 1: /*
2: * Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
3: * Copyright (C) 1999-2001 Internet Software Consortium.
4: *
5: * Permission to use, copy, modify, and/or distribute this software for any
6: * purpose with or without fee is hereby granted, provided that the above
7: * copyright notice and this permission notice appear in all copies.
8: *
9: * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10: * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11: * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12: * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13: * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14: * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15: * PERFORMANCE OF THIS SOFTWARE.
16: */
17:
18: /* $Id: msgcat.c,v 1.18 2007/06/19 23:47:18 tbox Exp $ */
19:
20: /*! \file msgcat.c
21: *
22: * \author Principal Author: Bob Halley
23: */
24:
25: #include <config.h>
26:
27: #include <stddef.h>
28: #include <stdlib.h>
29:
30: #include <isc/magic.h>
31: #include <isc/msgcat.h>
32: #include <isc/util.h>
33:
34: #ifdef HAVE_CATGETS
35: #include <nl_types.h> /* Required for nl_catd. */
36: #endif
37:
38: /*
39: * Implementation Notes:
40: *
41: * We use malloc() and free() instead of isc_mem_get() and isc_mem_put()
42: * because we don't want to require a memory context to be specified
43: * in order to use a message catalog.
44: */
45:
46: struct isc_msgcat {
47: unsigned int magic;
48: #ifdef HAVE_CATGETS
49: nl_catd catalog;
50: #endif
51: };
52:
53: #define MSGCAT_MAGIC ISC_MAGIC('M', 'C', 'a', 't')
54: #define VALID_MSGCAT(m) ISC_MAGIC_VALID(m, MSGCAT_MAGIC)
55:
56: void
57: isc_msgcat_open(const char *name, isc_msgcat_t **msgcatp) {
58: isc_msgcat_t *msgcat;
59:
60: /*
61: * Open a message catalog.
62: */
63:
64: REQUIRE(name != NULL);
65: REQUIRE(msgcatp != NULL && *msgcatp == NULL);
66:
67: msgcat = malloc(sizeof(*msgcat));
68: if (msgcat == NULL) {
69: *msgcatp = NULL;
70: return;
71: }
72:
73: #ifdef HAVE_CATGETS
74: /*
75: * We don't check if catopen() fails because we don't care.
76: * If it does fail, then when we call catgets(), it will use
77: * the default string.
78: */
79: msgcat->catalog = catopen(name, 0);
80: #endif
81: msgcat->magic = MSGCAT_MAGIC;
82:
83: *msgcatp = msgcat;
84: }
85:
86: void
87: isc_msgcat_close(isc_msgcat_t **msgcatp) {
88: isc_msgcat_t *msgcat;
89:
90: /*
91: * Close a message catalog.
92: */
93:
94: REQUIRE(msgcatp != NULL);
95: msgcat = *msgcatp;
96: REQUIRE(VALID_MSGCAT(msgcat) || msgcat == NULL);
97:
98: if (msgcat != NULL) {
99: #ifdef HAVE_CATGETS
100: if (msgcat->catalog != (nl_catd)(-1))
101: (void)catclose(msgcat->catalog);
102: #endif
103: msgcat->magic = 0;
104: free(msgcat);
105: }
106:
107: *msgcatp = NULL;
108: }
109:
110: const char *
111: isc_msgcat_get(isc_msgcat_t *msgcat, int set, int message,
112: const char *default_text)
113: {
114: /*
115: * Get message 'message' from message set 'set' in 'msgcat'. If it
116: * is not available, use 'default'.
117: */
118:
119: REQUIRE(VALID_MSGCAT(msgcat) || msgcat == NULL);
120: REQUIRE(set > 0);
121: REQUIRE(message > 0);
122: REQUIRE(default_text != NULL);
123:
124: #ifdef HAVE_CATGETS
125: if (msgcat == NULL)
126: return (default_text);
127: return (catgets(msgcat->catalog, set, message, default_text));
128: #else
129: return (default_text);
130: #endif
131: }
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>