codekingpro/portable-devtools

1// © 2016 and later: Unicode, Inc. and others.
2// License & terms of use: http://www.unicode.org/copyright.html
3/*
4*******************************************************************************
5*   Copyright (C) 2010-2012, International Business Machines
6*   Corporation and others.  All Rights Reserved.
7*******************************************************************************
8*   file name:  udicttrie.h
9*   encoding:   UTF-8
10*   tab size:   8 (not used)
11*   indentation:4
12*
13*   created on: 2010dec17
14*   created by: Markus W. Scherer
15*/
16
17#ifndef __USTRINGTRIE_H__
18#define __USTRINGTRIE_H__
19
20/**
21 * \file
22 * \brief C API: Helper definitions for dictionary trie APIs.
23 */
24
25#include "unicode/utypes.h"
26
27
28/**
29 * Return values for BytesTrie::next(), UCharsTrie::next() and similar methods.
30 * @see USTRINGTRIE_MATCHES
31 * @see USTRINGTRIE_HAS_VALUE
32 * @see USTRINGTRIE_HAS_NEXT
33 * @stable ICU 4.8
34 */
35enum UStringTrieResult {
36    /**
37     * The input unit(s) did not continue a matching string.
38     * Once current()/next() return USTRINGTRIE_NO_MATCH,
39     * all further calls to current()/next() will also return USTRINGTRIE_NO_MATCH,
40     * until the trie is reset to its original state or to a saved state.
41     * @stable ICU 4.8
42     */
43    USTRINGTRIE_NO_MATCH,
44    /**
45     * The input unit(s) continued a matching string
46     * but there is no value for the string so far.
47     * (It is a prefix of a longer string.)
48     * @stable ICU 4.8
49     */
50    USTRINGTRIE_NO_VALUE,
51    /**
52     * The input unit(s) continued a matching string
53     * and there is a value for the string so far.
54     * This value will be returned by getValue().
55     * No further input byte/unit can continue a matching string.
56     * @stable ICU 4.8
57     */
58    USTRINGTRIE_FINAL_VALUE,
59    /**
60     * The input unit(s) continued a matching string
61     * and there is a value for the string so far.
62     * This value will be returned by getValue().
63     * Another input byte/unit can continue a matching string.
64     * @stable ICU 4.8
65     */
66    USTRINGTRIE_INTERMEDIATE_VALUE
67};
68
69/**
70 * Same as (result!=USTRINGTRIE_NO_MATCH).
71 * @param result A result from BytesTrie::first(), UCharsTrie::next() etc.
72 * @return true if the input bytes/units so far are part of a matching string/byte sequence.
73 * @stable ICU 4.8
74 */
75#define USTRINGTRIE_MATCHES(result) ((result)!=USTRINGTRIE_NO_MATCH)
76
77/**
78 * Equivalent to (result==USTRINGTRIE_INTERMEDIATE_VALUE || result==USTRINGTRIE_FINAL_VALUE) but
79 * this macro evaluates result exactly once.
80 * @param result A result from BytesTrie::first(), UCharsTrie::next() etc.
81 * @return true if there is a value for the input bytes/units so far.
82 * @see BytesTrie::getValue
83 * @see UCharsTrie::getValue
84 * @stable ICU 4.8
85 */
86#define USTRINGTRIE_HAS_VALUE(result) ((result)>=USTRINGTRIE_FINAL_VALUE)
87
88/**
89 * Equivalent to (result==USTRINGTRIE_NO_VALUE || result==USTRINGTRIE_INTERMEDIATE_VALUE) but
90 * this macro evaluates result exactly once.
91 * @param result A result from BytesTrie::first(), UCharsTrie::next() etc.
92 * @return true if another input byte/unit can continue a matching string.
93 * @stable ICU 4.8
94 */
95#define USTRINGTRIE_HAS_NEXT(result) ((result)&1)
96
97#endif  /* __USTRINGTRIE_H__ */
98