aboutsummaryrefslogtreecommitdiffstats
path: root/native/jni/src/dictionary/utils/format_utils.h
blob: 1616efcce80d968f256f7d3e60e421b6c9609b33 (about) (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
/*
 * Copyright (C) 2013, The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef LATINIME_FORMAT_UTILS_H
#define LATINIME_FORMAT_UTILS_H

#include <cstdint>

#include "defines.h"
#include "utils/byte_array_view.h"

namespace latinime {

/**
 * Methods to handle binary dictionary format version.
 */
class FormatUtils {
 public:
    enum FORMAT_VERSION {
        // These MUST have the same values as the relevant constants in FormatSpec.java.
        // TODO: Remove VERSION_2 and VERSION_201 when we:
        // * Confirm that old versions of LatinIME download old-format dictionaries
        // * We no longer need the corresponding constants on the Java side for dicttool
        VERSION_2 = 2,
        VERSION_201 = 201,
        VERSION_202 = 202,
        VERSION_4_ONLY_FOR_TESTING = 399,
        VERSION_402 = 402,
        VERSION_403 = 403,
        UNKNOWN_VERSION = -1
    };

    // 32 bit magic number is stored at the beginning of the dictionary header to reject
    // unsupported or obsolete dictionary formats.
    static const uint32_t MAGIC_NUMBER;

    static FORMAT_VERSION getFormatVersion(const int formatVersion);
    static FORMAT_VERSION detectFormatVersion(const ReadOnlyByteArrayView dictBuffer);

 private:
    DISALLOW_IMPLICIT_CONSTRUCTORS(FormatUtils);

    static const size_t DICTIONARY_MINIMUM_SIZE;
};
} // namespace latinime
#endif /* LATINIME_FORMAT_UTILS_H */