SM0 She11

Full Path (server): /usr/include/unicode

📄 alphaindex.h [E] [D]
📄 appendable.h [E] [D]
📄 basictz.h [E] [D]
📄 bms.h [E] [D]
📄 bmsearch.h [E] [D]
📄 brkiter.h [E] [D]
📄 bytestream.h [E] [D]
📄 bytestrie.h [E] [D]
📄 bytestriebuilder.h [E] [D]
📄 calendar.h [E] [D]
📄 caniter.h [E] [D]
📄 chariter.h [E] [D]
📄 choicfmt.h [E] [D]
📄 coleitr.h [E] [D]
📄 coll.h [E] [D]
📄 colldata.h [E] [D]
📄 curramt.h [E] [D]
📄 currpinf.h [E] [D]
📄 currunit.h [E] [D]
📄 datefmt.h [E] [D]
📄 dbbi.h [E] [D]
📄 dcfmtsym.h [E] [D]
📄 decimfmt.h [E] [D]
📄 docmain.h [E] [D]
📄 dtfmtsym.h [E] [D]
📄 dtintrv.h [E] [D]
📄 dtitvfmt.h [E] [D]
📄 dtitvinf.h [E] [D]
📄 dtptngen.h [E] [D]
📄 dtrule.h [E] [D]
📄 enumset.h [E] [D]
📄 errorcode.h [E] [D]
📄 fieldpos.h [E] [D]
📄 fmtable.h [E] [D]
📄 format.h [E] [D]
📄 fpositer.h [E] [D]
📄 gender.h [E] [D]
📄 gregocal.h [E] [D]
📄 icudataver.h [E] [D]
📄 icuplug.h [E] [D]
📄 idna.h [E] [D]
📄 listformatter.h [E] [D]
📄 localpointer.h [E] [D]
📄 locdspnm.h [E] [D]
📄 locid.h [E] [D]
📄 measfmt.h [E] [D]
📄 measunit.h [E] [D]
📄 measure.h [E] [D]
📄 messagepattern.h [E] [D]
📄 msgfmt.h [E] [D]
📄 normalizer2.h [E] [D]
📄 normlzr.h [E] [D]
📄 numfmt.h [E] [D]
📄 numsys.h [E] [D]
📄 parseerr.h [E] [D]
📄 parsepos.h [E] [D]
📄 platform.h [E] [D]
📄 plurfmt.h [E] [D]
📄 plurrule.h [E] [D]
📄 ptypes.h [E] [D]
📄 putil.h [E] [D]
📄 rbbi.h [E] [D]
📄 rbnf.h [E] [D]
📄 rbtz.h [E] [D]
📄 regex.h [E] [D]
📄 rep.h [E] [D]
📄 resbund.h [E] [D]
📄 schriter.h [E] [D]
📄 search.h [E] [D]
📄 selfmt.h [E] [D]
📄 simpletz.h [E] [D]
📄 smpdtfmt.h [E] [D]
📄 sortkey.h [E] [D]
📄 std_string.h [E] [D]
📄 strenum.h [E] [D]
📄 stringpiece.h [E] [D]
📄 stringtriebuilder.h [E] [D]
📄 stsearch.h [E] [D]
📄 symtable.h [E] [D]
📄 tblcoll.h [E] [D]
📄 timezone.h [E] [D]
📄 tmunit.h [E] [D]
📄 tmutamt.h [E] [D]
📄 tmutfmt.h [E] [D]
📄 translit.h [E] [D]
📄 tzfmt.h [E] [D]
📄 tznames.h [E] [D]
📄 tzrule.h [E] [D]
📄 tztrans.h [E] [D]
📄 ubidi.h [E] [D]
📄 ubrk.h [E] [D]
📄 ucal.h [E] [D]
📄 ucasemap.h [E] [D]
📄 ucat.h [E] [D]
📄 uchar.h [E] [D]
📄 ucharstrie.h [E] [D]
📄 ucharstriebuilder.h [E] [D]
📄 uchriter.h [E] [D]
📄 uclean.h [E] [D]
📄 ucnv.h [E] [D]
📄 ucnv_cb.h [E] [D]
📄 ucnv_err.h [E] [D]
📄 ucnvsel.h [E] [D]
📄 ucol.h [E] [D]
📄 ucoleitr.h [E] [D]
📄 uconfig.h [E] [D]
📄 ucsdet.h [E] [D]
📄 ucurr.h [E] [D]
📄 udat.h [E] [D]
📄 udata.h [E] [D]
📄 udateintervalformat.h [E] [D]
📄 udatpg.h [E] [D]
📄 udisplaycontext.h [E] [D]
📄 uenum.h [E] [D]
📄 ugender.h [E] [D]
📄 uidna.h [E] [D]
📄 uiter.h [E] [D]
📄 uldnames.h [E] [D]
📄 uloc.h [E] [D]
📄 ulocdata.h [E] [D]
📄 umachine.h [E] [D]
📄 umisc.h [E] [D]
📄 umsg.h [E] [D]
📄 unifilt.h [E] [D]
📄 unifunct.h [E] [D]
📄 unimatch.h [E] [D]
📄 unirepl.h [E] [D]
📄 uniset.h [E] [D]
📄 unistr.h [E] [D]
📄 unorm.h [E] [D]
📄 unorm2.h [E] [D]
📄 unum.h [E] [D]
📄 uobject.h [E] [D]
📄 upluralrules.h [E] [D]
📄 uregex.h [E] [D]
📄 urename.h [E] [D]
📄 urep.h [E] [D]
📄 ures.h [E] [D]
📄 uscript.h [E] [D]
📄 usearch.h [E] [D]
📄 uset.h [E] [D]
📄 usetiter.h [E] [D]
📄 ushape.h [E] [D]
📄 uspoof.h [E] [D]
📄 usprep.h [E] [D]
📄 ustdio.h [E] [D]
📄 ustream.h [E] [D]
📄 ustring.h [E] [D]
📄 ustringtrie.h [E] [D]
📄 utext.h [E] [D]
📄 utf.h [E] [D]
📄 utf16.h [E] [D]
📄 utf32.h [E] [D]
📄 utf8.h [E] [D]
📄 utf_old.h [E] [D]
📄 utmscale.h [E] [D]
📄 utrace.h [E] [D]
📄 utrans.h [E] [D]
📄 utypes.h [E] [D]
📄 uvernum.h [E] [D]
📄 uversion.h [E] [D]
📄 vtzone.h [E] [D]

Editing: uldnames.h

/*
*******************************************************************************
*   Copyright (C) 2010-2012, International Business Machines Corporation and       * 
*   others.  All Rights Reserved.                                             *
*******************************************************************************
*/

#ifndef __ULDNAMES_H__
#define __ULDNAMES_H__

/**
 * \file
 * \brief C API: Provides display names of Locale ids and their components.
 */

#include "unicode/utypes.h"
#include "unicode/localpointer.h"
#include "unicode/uscript.h"
#include "unicode/udisplaycontext.h"

/**
 * Enum used in LocaleDisplayNames::createInstance.
 * @stable ICU 4.4
 */
typedef enum {
    /**
     * Use standard names when generating a locale name,
     * e.g. en_GB displays as 'English (United Kingdom)'.
     * @stable ICU 4.4
     */
    ULDN_STANDARD_NAMES = 0,
    /**
     * Use dialect names, when generating a locale name,
     * e.g. en_GB displays as 'British English'.
     * @stable ICU 4.4
     */
    ULDN_DIALECT_NAMES
} UDialectHandling;

/**
 * Opaque C service object type for the locale display names API
 * @stable ICU 4.4
 */
struct ULocaleDisplayNames;

/** 
 * C typedef for struct ULocaleDisplayNames. 
 * @stable ICU 4.4 
 */
typedef struct ULocaleDisplayNames ULocaleDisplayNames;

#if !UCONFIG_NO_FORMATTING

/**
 * Returns an instance of LocaleDisplayNames that returns names
 * formatted for the provided locale, using the provided
 * dialectHandling.  The usual value for dialectHandling is
 * ULOC_STANDARD_NAMES.
 *
 * @param locale the display locale 
 * @param dialectHandling how to select names for locales 
 * @return a ULocaleDisplayNames instance 
 * @param pErrorCode the status code
 * @stable ICU 4.4
 */
U_STABLE ULocaleDisplayNames * U_EXPORT2
uldn_open(const char * locale,
          UDialectHandling dialectHandling,
          UErrorCode *pErrorCode);

/**
 * Closes a ULocaleDisplayNames instance obtained from uldn_open().
 * @param ldn the ULocaleDisplayNames instance to be closed
 * @stable ICU 4.4
 */
U_STABLE void U_EXPORT2
uldn_close(ULocaleDisplayNames *ldn);

#if U_SHOW_CPLUSPLUS_API

U_NAMESPACE_BEGIN

/**
 * \class LocalULocaleDisplayNamesPointer
 * "Smart pointer" class, closes a ULocaleDisplayNames via uldn_close().
 * For most methods see the LocalPointerBase base class.
 *
 * @see LocalPointerBase
 * @see LocalPointer
 * @stable ICU 4.4
 */
U_DEFINE_LOCAL_OPEN_POINTER(LocalULocaleDisplayNamesPointer, ULocaleDisplayNames, uldn_close);

U_NAMESPACE_END

#endif

/* getters for state */

/**
 * Returns the locale used to determine the display names. This is
 * not necessarily the same locale passed to {@link #uldn_open}.
 * @param ldn the LocaleDisplayNames instance
 * @return the display locale 
 * @stable ICU 4.4
 */
U_STABLE const char * U_EXPORT2
uldn_getLocale(const ULocaleDisplayNames *ldn);

/**
 * Returns the dialect handling used in the display names.
 * @param ldn the LocaleDisplayNames instance
 * @return the dialect handling enum
 * @stable ICU 4.4
 */
U_STABLE UDialectHandling U_EXPORT2
uldn_getDialectHandling(const ULocaleDisplayNames *ldn);

/* names for entire locales */

/**
 * Returns the display name of the provided locale.
 * @param ldn the LocaleDisplayNames instance
 * @param locale the locale whose display name to return
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_localeDisplayName(const ULocaleDisplayNames *ldn,
                       const char *locale,
                       UChar *result,
                       int32_t maxResultSize,
                       UErrorCode *pErrorCode);

/* names for components of a locale */

/**
 * Returns the display name of the provided language code.
 * @param ldn the LocaleDisplayNames instance
 * @param lang the language code whose display name to return
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_languageDisplayName(const ULocaleDisplayNames *ldn,
                         const char *lang,
                         UChar *result,
                         int32_t maxResultSize,
                         UErrorCode *pErrorCode);

/**
 * Returns the display name of the provided script.
 * @param ldn the LocaleDisplayNames instance
 * @param script the script whose display name to return
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_scriptDisplayName(const ULocaleDisplayNames *ldn,
                       const char *script,
                       UChar *result,
                       int32_t maxResultSize,
                       UErrorCode *pErrorCode);

/**
 * Returns the display name of the provided script code.
 * @param ldn the LocaleDisplayNames instance
 * @param scriptCode the script code whose display name to return
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_scriptCodeDisplayName(const ULocaleDisplayNames *ldn,
                           UScriptCode scriptCode,
                           UChar *result,
                           int32_t maxResultSize,
                           UErrorCode *pErrorCode);

/**
 * Returns the display name of the provided region code.
 * @param ldn the LocaleDisplayNames instance
 * @param region the region code whose display name to return
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_regionDisplayName(const ULocaleDisplayNames *ldn,
                       const char *region,
                       UChar *result,
                       int32_t maxResultSize,
                       UErrorCode *pErrorCode);

/**
 * Returns the display name of the provided variant
 * @param ldn the LocaleDisplayNames instance
 * @param variant the variant whose display name to return
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_variantDisplayName(const ULocaleDisplayNames *ldn,
                        const char *variant,
                        UChar *result,
                        int32_t maxResultSize,
                        UErrorCode *pErrorCode);

/**
 * Returns the display name of the provided locale key
 * @param ldn the LocaleDisplayNames instance
 * @param key the locale key whose display name to return
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_keyDisplayName(const ULocaleDisplayNames *ldn,
                    const char *key,
                    UChar *result,
                    int32_t maxResultSize,
                    UErrorCode *pErrorCode);

/**
 * Returns the display name of the provided value (used with the provided key).
 * @param ldn the LocaleDisplayNames instance
 * @param key the locale key
 * @param value the locale key's value
 * @param result receives the display name
 * @param maxResultSize the size of the result buffer
 * @param pErrorCode the status code
 * @return the actual buffer size needed for the display name.  If it's
 * greater than maxResultSize, the returned name will be truncated.
 * @stable ICU 4.4
 */
U_STABLE int32_t U_EXPORT2
uldn_keyValueDisplayName(const ULocaleDisplayNames *ldn,
                         const char *key,
                         const char *value,
                         UChar *result,
                         int32_t maxResultSize,
                         UErrorCode *pErrorCode);

#ifndef U_HIDE_INTERNAL_API
/**
* Returns an instance of LocaleDisplayNames that returns names formatted
* for the provided locale, using the provided UDisplayContext settings.
*
* @param locale The display locale 
* @param contexts List of one or more context settings (e.g. for dialect
*               handling, capitalization, etc.
* @param length Number of items in the contexts list
* @param pErrorCode Pointer to UErrorCode input/output status. If at entry this indicates
*               a failure status, the function will do nothing; otherwise this will be
*               updated with any new status from the function. 
* @return a ULocaleDisplayNames instance 
* @internal ICU 50 technology preview
*/
U_INTERNAL ULocaleDisplayNames * U_EXPORT2
uldn_openForContext(const char * locale, UDisplayContext *contexts,
                    int32_t length, UErrorCode *pErrorCode);

/**
* Returns the UDisplayContext value for the specified UDisplayContextType.
* @param ldn the ULocaleDisplayNames instance
* @param type the UDisplayContextType whose value to return
* @param pErrorCode Pointer to UErrorCode input/output status. If at entry this indicates
*               a failure status, the function will do nothing; otherwise this will be
*               updated with any new status from the function. 
* @return the UDisplayContextValue for the specified type.
* @internal ICU 50 technology preview
*/
U_INTERNAL UDisplayContext U_EXPORT2
uldn_getContext(const ULocaleDisplayNames *ldn, UDisplayContextType type,
                UErrorCode *pErrorCode);

#endif  /* U_HIDE_INTERNAL_API */

#endif  /* !UCONFIG_NO_FORMATTING */
#endif  /* __ULDNAMES_H__ */