🐐 GOAT

🐐 GOAT Shell

Current path: opt/alt/libicu65/usr/include/unicode/

✏️ Editing: ucat.h

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
**********************************************************************
* Copyright (c) 2003-2004, International Business Machines
* Corporation and others.  All Rights Reserved.
**********************************************************************
* Author: Alan Liu
* Created: March 19 2003
* Since: ICU 2.6
**********************************************************************
*/
#ifndef UCAT_H
#define UCAT_H

#include "unicode/utypes.h"
#include "unicode/ures.h"

/**
 * \file
 * \brief C API: Message Catalog Wrappers
 *
 * This C API provides look-alike functions that deliberately resemble
 * the POSIX catopen, catclose, and catgets functions.  The underlying
 * implementation is in terms of ICU resource bundles, rather than
 * POSIX message catalogs.
 *
 * The ICU resource bundles obey standard ICU inheritance policies.
 * To facilitate this, sets and messages are flattened into one tier.
 * This is done by creating resource bundle keys of the form
 * &lt;set_num&gt;%&lt;msg_num&gt; where set_num is the set number and msg_num is
 * the message number, formatted as decimal strings.
 *
 * Example:  Consider a message catalog containing two sets:
 *
 * Set 1: Message 4  = "Good morning."
 *        Message 5  = "Good afternoon."
 *        Message 7  = "Good evening."
 *        Message 8  = "Good night."
 * Set 4: Message 14 = "Please "
 *        Message 19 = "Thank you."
 *        Message 20 = "Sincerely,"
 *
 * The ICU resource bundle source file would, assuming it is named
 * "greet.txt", would look like this:
 *
 * greet
 * {
 *     1%4  { "Good morning." }
 *     1%5  { "Good afternoon." }
 *     1%7  { "Good evening." }
 *     1%8  { "Good night." }
 * 
 *     4%14 { "Please " }
 *     4%19 { "Thank you." }
 *     4%20 { "Sincerely," }
 * }
 *
 * The catgets function is commonly used in combination with functions
 * like printf and strftime.  ICU components like message format can
 * be used instead, although they use a different format syntax.
 * There is an ICU package, icuio, that provides some of
 * the POSIX-style formatting API.
 */

U_CDECL_BEGIN

/**
 * An ICU message catalog descriptor, analogous to nl_catd.
 * 
 * @stable ICU 2.6
 */
typedef UResourceBundle* u_nl_catd;

/**
 * Open and return an ICU message catalog descriptor. The descriptor
 * may be passed to u_catgets() to retrieve localized strings.
 *
 * @param name string containing the full path pointing to the
 * directory where the resources reside followed by the package name
 * e.g. "/usr/resource/my_app/resources/guimessages" on a Unix system.
 * If NULL, ICU default data files will be used.
 *
 * Unlike POSIX, environment variables are not interpolated within the
 * name.
 *
 * @param locale the locale for which we want to open the resource. If
 * NULL, the default ICU locale will be used (see uloc_getDefault). If
 * strlen(locale) == 0, the root locale will be used.
 *
 * @param ec input/output error code. Upon output,
 * U_USING_FALLBACK_WARNING indicates that a fallback locale was
 * used. For example, 'de_CH' was requested, but nothing was found
 * there, so 'de' was used. U_USING_DEFAULT_WARNING indicates that the
 * default locale data or root locale data was used; neither the
 * requested locale nor any of its fallback locales were found.
 *
 * @return a message catalog descriptor that may be passed to
 * u_catgets(). If the ec parameter indicates success, then the caller
 * is responsible for calling u_catclose() to close the message
 * catalog. If the ec parameter indicates failure, then NULL will be
 * returned.
 * 
 * @stable ICU 2.6
 */
U_STABLE u_nl_catd U_EXPORT2
u_catopen(const char* name, const char* locale, UErrorCode* ec);

/**
 * Close an ICU message catalog, given its descriptor.
 *
 * @param catd a message catalog descriptor to be closed. May be NULL,
 * in which case no action is taken.
 * 
 * @stable ICU 2.6
 */
U_STABLE void U_EXPORT2
u_catclose(u_nl_catd catd);

/**
 * Retrieve a localized string from an ICU message catalog.
 *
 * @param catd a message catalog descriptor returned by u_catopen.
 *
 * @param set_num the message catalog set number. Sets need not be
 * numbered consecutively.
 *
 * @param msg_num the message catalog message number within the
 * set. Messages need not be numbered consecutively.
 *
 * @param s the default string. This is returned if the string
 * specified by the set_num and msg_num is not found. It must be
 * zero-terminated.
 *
 * @param len fill-in parameter to receive the length of the result.
 * May be NULL, in which case it is ignored.
 *
 * @param ec input/output error code. May be U_USING_FALLBACK_WARNING
 * or U_USING_DEFAULT_WARNING. U_MISSING_RESOURCE_ERROR indicates that
 * the set_num/msg_num tuple does not specify a valid message string
 * in this catalog.
 *
 * @return a pointer to a zero-terminated UChar array which lives in
 * an internal buffer area, typically a memory mapped/DLL file. The
 * caller must NOT delete this pointer. If the call is unsuccessful
 * for any reason, then s is returned.  This includes the situation in
 * which ec indicates a failing error code upon entry to this
 * function.
 * 
 * @stable ICU 2.6
 */
U_STABLE const UChar* U_EXPORT2
u_catgets(u_nl_catd catd, int32_t set_num, int32_t msg_num,
          const UChar* s,
          int32_t* len, UErrorCode* ec);

U_CDECL_END

#endif /*UCAT_H*/
/*eof*/

📄 alphaindex.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 appendable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 basictz.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 brkiter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 bytestream.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 bytestrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 bytestriebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 calendar.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 caniter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 casemap.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 char16ptr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 chariter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 choicfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 coleitr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 coll.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 compactdecimalformat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 curramt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 currpinf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 currunit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 datefmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dbbi.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dcfmtsym.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 decimfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 docmain.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtfmtsym.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtintrv.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtitvfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtitvinf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtptngen.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtrule.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 edits.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 enumset.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 errorcode.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 fieldpos.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 filteredbrk.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 fmtable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 format.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 formattedvalue.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 fpositer.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 gender.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 gregocal.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 icudataver.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 icuplug.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 idna.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 listformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 localebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 localematcher.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 localpointer.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 locdspnm.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 locid.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 measfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 measunit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 measure.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 messagepattern.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 msgfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 normalizer2.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 normlzr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 nounit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numberformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numberrangeformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numsys.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 parseerr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 parsepos.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 platform.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 plurfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 plurrule.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ptypes.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 putil.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rbbi.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rbnf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rbtz.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 regex.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 region.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 reldatefmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rep.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 resbund.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 schriter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 scientificnumberformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 search.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 selfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 simpleformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 simpletz.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 smpdtfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 sortkey.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 std_string.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 strenum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stringoptions.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stringpiece.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stringtriebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stsearch.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 symtable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tblcoll.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 timezone.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tmunit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tmutamt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tmutfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 translit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tzfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tznames.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tzrule.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tztrans.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ubidi.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ubiditransform.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ubrk.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucal.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucasemap.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uchar.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucharstrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucharstriebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uchriter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uclean.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnv.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnvsel.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnv_cb.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnv_err.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucol.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucoleitr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uconfig.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucpmap.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucptrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucsdet.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucurr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udata.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udateintervalformat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udatpg.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udisplaycontext.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uenum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ufieldpositer.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uformattable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uformattedvalue.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ugender.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uidna.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uiter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uldnames.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ulistformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uloc.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ulocdata.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umachine.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umisc.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umsg.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umutablecptrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unifilt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unifunct.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unimatch.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unirepl.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uniset.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unistr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unorm.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unorm2.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unumberformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unumsys.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uobject.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 upluralrules.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uregex.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uregion.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ureldatefmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 urename.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 urep.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ures.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uscript.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 usearch.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uset.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 usetiter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ushape.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uspoof.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 usprep.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustdio.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustream.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustring.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustringtrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utext.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf8.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf16.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf32.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf_old.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utmscale.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utrace.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utrans.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utypes.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uvernum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uversion.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 vtzone.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete

🐐 GOAT Shell

✏️ Editing: ucat.h

📤 Upload File

📁 Create Folder