Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef BASE_NATIVE_LIBRARY_H_ | 5 #ifndef BASE_NATIVE_LIBRARY_H_ |
| 6 #define BASE_NATIVE_LIBRARY_H_ | 6 #define BASE_NATIVE_LIBRARY_H_ |
| 7 | 7 |
| 8 // This file defines a cross-platform "NativeLibrary" type which represents | 8 // This file defines a cross-platform "NativeLibrary" type which represents |
| 9 // a loadable module. | 9 // a loadable module. |
| 10 | 10 |
| 11 #include <iosfwd> | |
| 12 | |
| 11 #include "base/base_export.h" | 13 #include "base/base_export.h" |
| 12 #include "base/compiler_specific.h" | 14 #include "base/compiler_specific.h" |
| 13 #include "build/build_config.h" | 15 #include "build/build_config.h" |
| 14 | 16 |
| 15 #if defined(OS_WIN) | 17 #if defined(OS_WIN) |
| 16 #include <windows.h> | 18 #include <windows.h> |
| 17 #elif defined(OS_MACOSX) | 19 #elif defined(OS_MACOSX) |
| 18 #import <CoreFoundation/CoreFoundation.h> | 20 #import <CoreFoundation/CoreFoundation.h> |
| 19 #endif // OS_* | 21 #endif // OS_* |
| 20 | 22 |
| (...skipping 22 matching lines...) Expand all Loading... | |
| 43 union { | 45 union { |
| 44 CFBundleRef bundle; | 46 CFBundleRef bundle; |
| 45 void* dylib; | 47 void* dylib; |
| 46 }; | 48 }; |
| 47 }; | 49 }; |
| 48 typedef NativeLibraryStruct* NativeLibrary; | 50 typedef NativeLibraryStruct* NativeLibrary; |
| 49 #elif defined(OS_POSIX) | 51 #elif defined(OS_POSIX) |
| 50 typedef void* NativeLibrary; | 52 typedef void* NativeLibrary; |
| 51 #endif // OS_* | 53 #endif // OS_* |
| 52 | 54 |
| 55 struct NativeLibraryLoadError { | |
| 56 #if defined(OS_WIN) | |
| 57 NativeLibraryLoadError() : code(0) {} | |
| 58 DWORD code; | |
| 59 #else | |
| 60 std::string message; | |
| 61 #endif // OS_WIN | |
| 62 }; | |
| 63 | |
| 53 // Loads a native library from disk. Release it with UnloadNativeLibrary when | 64 // Loads a native library from disk. Release it with UnloadNativeLibrary when |
| 54 // you're done. Returns NULL on failure. | 65 // you're done. Returns NULL on failure. |
| 55 // If |error| is not NULL, it may be filled in with an error message on error. | 66 // If |error| is not NULL, it may be filled in on load error. |
| 56 BASE_EXPORT NativeLibrary LoadNativeLibrary(const FilePath& library_path, | 67 BASE_EXPORT NativeLibrary LoadNativeLibrary(const FilePath& library_path, |
| 57 std::string* error); | 68 NativeLibraryLoadError* error); |
| 58 | 69 |
| 59 #if defined(OS_WIN) | 70 #if defined(OS_WIN) |
| 60 // Loads a native library from disk. Release it with UnloadNativeLibrary when | 71 // Loads a native library from disk. Release it with UnloadNativeLibrary when |
| 61 // you're done. | 72 // you're done. |
| 62 // This function retrieves the LoadLibrary function exported from kernel32.dll | 73 // This function retrieves the LoadLibrary function exported from kernel32.dll |
| 63 // and calls it instead of directly calling the LoadLibrary function via the | 74 // and calls it instead of directly calling the LoadLibrary function via the |
| 64 // import table. | 75 // import table. |
| 65 BASE_EXPORT NativeLibrary LoadNativeLibraryDynamically( | 76 BASE_EXPORT NativeLibrary LoadNativeLibraryDynamically( |
| 66 const FilePath& library_path); | 77 const FilePath& library_path); |
| 67 #endif // OS_WIN | 78 #endif // OS_WIN |
| 68 | 79 |
| 69 // Unloads a native library. | 80 // Unloads a native library. |
| 70 BASE_EXPORT void UnloadNativeLibrary(NativeLibrary library); | 81 BASE_EXPORT void UnloadNativeLibrary(NativeLibrary library); |
| 71 | 82 |
| 72 // Gets a function pointer from a native library. | 83 // Gets a function pointer from a native library. |
| 73 BASE_EXPORT void* GetFunctionPointerFromNativeLibrary(NativeLibrary library, | 84 BASE_EXPORT void* GetFunctionPointerFromNativeLibrary(NativeLibrary library, |
| 74 const char* name); | 85 const char* name); |
| 75 | 86 |
| 76 // Returns the full platform specific name for a native library. | 87 // Returns the full platform specific name for a native library. |
| 77 // For example: | 88 // For example: |
| 78 // "mylib" returns "mylib.dll" on Windows, "libmylib.so" on Linux, | 89 // "mylib" returns "mylib.dll" on Windows, "libmylib.so" on Linux, |
| 79 // "mylib.dylib" on Mac. | 90 // "mylib.dylib" on Mac. |
| 80 BASE_EXPORT string16 GetNativeLibraryName(const string16& name); | 91 BASE_EXPORT string16 GetNativeLibraryName(const string16& name); |
| 81 | 92 |
| 93 // Stream operator so NativeLibraryLoadError can be used in log statements. | |
| 94 BASE_EXPORT std::ostream& operator<<(std::ostream& out, | |
|
brettw
2014/03/24 17:21:25
The style guide permits operator<< for logging but
xhwang
2014/03/24 17:53:21
Done.
| |
| 95 const NativeLibraryLoadError& error); | |
| 96 | |
| 82 } // namespace base | 97 } // namespace base |
| 83 | 98 |
| 84 #endif // BASE_NATIVE_LIBRARY_H_ | 99 #endif // BASE_NATIVE_LIBRARY_H_ |
| OLD | NEW |