Annotation of embedaddon/ntp/lib/isc/nls/msgcat.c, revision 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>