1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef BASE_I18N_ICU_UTIL_H_
6 #define BASE_I18N_ICU_UTIL_H_
10 #include "base/files/memory_mapped_file.h"
11 #include "base/i18n/base_i18n_export.h"
12 #include "build/build_config.h"
14 #define ICU_UTIL_DATA_FILE 0
15 #define ICU_UTIL_DATA_SHARED 1
16 #define ICU_UTIL_DATA_STATIC 2
22 // Call this function to load ICU's data tables for the current process. This
23 // function should be called before ICU is used.
24 BASE_I18N_EXPORT bool InitializeICU();
26 #if ICU_UTIL_DATA_IMPL == ICU_UTIL_DATA_FILE
27 #if defined(OS_ANDROID)
28 // Returns the PlatformFile and Region that was initialized by InitializeICU().
29 // Use with InitializeICUWithFileDescriptor().
30 BASE_I18N_EXPORT PlatformFile GetIcuDataFileHandle(
31 MemoryMappedFile::Region* out_region);
33 // Android uses a file descriptor passed by browser process to initialize ICU
34 // in render processes.
35 BASE_I18N_EXPORT bool InitializeICUWithFileDescriptor(
37 const MemoryMappedFile::Region& data_region);
40 // Returns a void pointer to the memory mapped ICU data file.
42 // There are cases on Android where we would be unsafely reusing a file
43 // descriptor within the same process when initializing two copies of ICU from
44 // different binaries in the same address space. This returns an unowned
45 // pointer to the memory mapped icu data file; consumers copies of base must
46 // not outlive the copy of base that owns the memory mapped file.
47 BASE_I18N_EXPORT const uint8_t* GetRawIcuMemory();
49 // Initializes ICU memory
51 // This does nothing in component builds; this initialization should only be
52 // done in cases where there could be two copies of base in a single process in
53 // non-component builds. (The big example is standalone service libraries: the
54 // Service Manager will have a copy of base linked in, and the majority of
55 // service libraries will have base linked in but in non-component builds,
56 // these will be separate copies of base.)
57 BASE_I18N_EXPORT bool InitializeICUFromRawMemory(const uint8_t* raw_memory);
58 #endif // ICU_UTIL_DATA_IMPL == ICU_UTIL_DATA_FILE
59 #endif // !defined(OS_NACL)
61 // In a test binary, the call above might occur twice.
62 BASE_I18N_EXPORT void AllowMultipleInitializeCallsForTesting();
67 #endif // BASE_I18N_ICU_UTIL_H_