1 /*
2  * Copyright (C) 2018 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef IDMAP2_INCLUDE_IDMAP2_RESOURCEUTILS_H_
18 #define IDMAP2_INCLUDE_IDMAP2_RESOURCEUTILS_H_
19 
20 #include <optional>
21 #include <string>
22 
23 #include "androidfw/AssetManager2.h"
24 #include "idmap2/Result.h"
25 
26 namespace android::idmap2 {
27 
28 #define EXTRACT_TYPE(resid) ((0x00ff0000 & (resid)) >> 16)
29 #define EXTRACT_ENTRY(resid) (0x0000ffff & (resid))
30 
31 // use typedefs to let the compiler warn us about implicit casts
32 using ResourceId = uint32_t;  // 0xpptteeee
33 using PackageId = uint8_t;    // pp in 0xpptteeee
34 using TypeId = uint8_t;       // tt in 0xpptteeee
35 using EntryId = uint16_t;     // eeee in 0xpptteeee
36 
37 using DataType = uint8_t;    // Res_value::dataType
38 using DataValue = uint32_t;  // Res_value::data
39 
40 struct TargetValue {
41   DataType data_type;
42   DataValue data_value;
43 };
44 
45 namespace utils {
46 
47 // Returns whether the Res_value::data_type represents a dynamic or regular resource reference.
48 bool IsReference(uint8_t data_type);
49 
50 // Converts the Res_value::data_type to a human-readable string representation.
51 StringPiece DataTypeToString(uint8_t data_type);
52 
53 // Retrieves the type and entry name of the resource in the AssetManager in the form type/entry.
54 Result<std::string> ResToTypeEntryName(const AssetManager2& am, ResourceId resid);
55 
56 }  // namespace utils
57 }  // namespace android::idmap2
58 
59 #endif  // IDMAP2_INCLUDE_IDMAP2_RESOURCEUTILS_H_
60