OLD | NEW |
1 /* | 1 /* |
2 * Copyright 2012 Google Inc. | 2 * Copyright 2012 Google Inc. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license that can be | 4 * Use of this source code is governed by a BSD-style license that can be |
5 * found in the LICENSE file. | 5 * found in the LICENSE file. |
6 */ | 6 */ |
7 | 7 |
8 #ifndef SkTLS_DEFINED | 8 #ifndef SkTLS_DEFINED |
9 #define SkTLS_DEFINED | 9 #define SkTLS_DEFINED |
10 | 10 |
11 #include "SkTypes.h" | 11 #include "SkTypes.h" |
12 | 12 |
13 /** | 13 /** |
14 * Maintains a per-thread cache, using a CreateProc as the key into that cache. | 14 * Maintains a per-thread cache, using a CreateProc as the key into that cache. |
15 */ | 15 */ |
16 class SkTLS { | 16 class SkTLS { |
17 public: | 17 public: |
18 typedef void* (*CreateProc)(); | 18 typedef void* (*CreateProc)(); |
19 typedef void (*DeleteProc)(void*); | 19 typedef void (*DeleteProc)(void*); |
20 | 20 |
21 /** | 21 /** |
22 * If Get() has previously been called with this CreateProc, then this | 22 * If Get() has previously been called with this CreateProc, then this |
23 * returns its cached data, otherwise it returns NULL. The CreateProc is | 23 * returns its cached data, otherwise it returns nullptr. The CreateProc is |
24 * never invoked in Find, it is only used as a key for searching the | 24 * never invoked in Find, it is only used as a key for searching the |
25 * cache. | 25 * cache. |
26 */ | 26 */ |
27 static void* Find(CreateProc); | 27 static void* Find(CreateProc); |
28 | 28 |
29 /** | 29 /** |
30 * Return the cached data that was returned by the CreateProc. This proc | 30 * Return the cached data that was returned by the CreateProc. This proc |
31 * is only called the first time Get is called, and there after it is | 31 * is only called the first time Get is called, and there after it is |
32 * cached (per-thread), using the CreateProc as a key to look it up. | 32 * cached (per-thread), using the CreateProc as a key to look it up. |
33 * | 33 * |
(...skipping 11 matching lines...) Expand all Loading... |
45 static void Delete(CreateProc); | 45 static void Delete(CreateProc); |
46 | 46 |
47 private: | 47 private: |
48 // Our implementation requires only 1 TLS slot, as we manage multiple values | 48 // Our implementation requires only 1 TLS slot, as we manage multiple values |
49 // ourselves in a list, with the platform specific value as our head. | 49 // ourselves in a list, with the platform specific value as our head. |
50 | 50 |
51 /** | 51 /** |
52 * Implemented by the platform, to return the value of our (one) slot per-t
hread | 52 * Implemented by the platform, to return the value of our (one) slot per-t
hread |
53 * | 53 * |
54 * If forceCreateTheSlot is true, then we must have created the "slot" for | 54 * If forceCreateTheSlot is true, then we must have created the "slot" for |
55 * our TLS, even though we know that the return value will be NULL in that | 55 * our TLS, even though we know that the return value will be nullptr in th
at |
56 * case (i.e. no-slot and first-time-slot both return NULL). This ensures | 56 * case (i.e. no-slot and first-time-slot both return nullptr). This ensure
s |
57 * that after calling GetSpecific, we know that we can legally call | 57 * that after calling GetSpecific, we know that we can legally call |
58 * SetSpecific. | 58 * SetSpecific. |
59 * | 59 * |
60 * If forceCreateTheSlot is false, then the impl can either create the | 60 * If forceCreateTheSlot is false, then the impl can either create the |
61 * slot or not. | 61 * slot or not. |
62 */ | 62 */ |
63 static void* PlatformGetSpecific(bool forceCreateTheSlot); | 63 static void* PlatformGetSpecific(bool forceCreateTheSlot); |
64 | 64 |
65 /** | 65 /** |
66 * Implemented by the platform, to set the value for our (one) slot per-thr
ead | 66 * Implemented by the platform, to set the value for our (one) slot per-thr
ead |
67 * | 67 * |
68 * The implementation can rely on GetSpecific(true) having been previously | 68 * The implementation can rely on GetSpecific(true) having been previously |
69 * called before SetSpecific is called. | 69 * called before SetSpecific is called. |
70 */ | 70 */ |
71 static void PlatformSetSpecific(void*); | 71 static void PlatformSetSpecific(void*); |
72 | 72 |
73 public: | 73 public: |
74 /** | 74 /** |
75 * Will delete our internal list. To be called by the platform if/when its | 75 * Will delete our internal list. To be called by the platform if/when its |
76 * TLS slot is deleted (often at thread shutdown). | 76 * TLS slot is deleted (often at thread shutdown). |
77 * | 77 * |
78 * Public *only* for the platform's use, not to be called by a client. | 78 * Public *only* for the platform's use, not to be called by a client. |
79 */ | 79 */ |
80 static void Destructor(void* ptr); | 80 static void Destructor(void* ptr); |
81 }; | 81 }; |
82 | 82 |
83 #endif | 83 #endif |
OLD | NEW |