| OLD | NEW |
| 1 // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2006-2008 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 // This file specifies a recursive data storage class called Value | 5 // This file specifies a recursive data storage class called Value |
| 6 // intended for storing setting and other persistable data. | 6 // intended for storing setting and other persistable data. |
| 7 // It includes the ability to specify (recursive) lists and dictionaries, so | 7 // It includes the ability to specify (recursive) lists and dictionaries, so |
| 8 // it's fairly expressive. However, the API is optimized for the common case, | 8 // it's fairly expressive. However, the API is optimized for the common case, |
| 9 // namely storing a hierarchical tree of simple values. Given a | 9 // namely storing a hierarchical tree of simple values. Given a |
| 10 // DictionaryValue root, you can easily do things like: | 10 // DictionaryValue root, you can easily do things like: |
| (...skipping 153 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 164 public: | 164 public: |
| 165 // Creates a Value to represent a binary buffer. The new object takes | 165 // Creates a Value to represent a binary buffer. The new object takes |
| 166 // ownership of the pointer passed in, if successful. | 166 // ownership of the pointer passed in, if successful. |
| 167 // Returns NULL if buffer is NULL. | 167 // Returns NULL if buffer is NULL. |
| 168 static BinaryValue* Create(char* buffer, size_t size); | 168 static BinaryValue* Create(char* buffer, size_t size); |
| 169 | 169 |
| 170 // For situations where you want to keep ownership of your buffer, this | 170 // For situations where you want to keep ownership of your buffer, this |
| 171 // factory method creates a new BinaryValue by copying the contents of the | 171 // factory method creates a new BinaryValue by copying the contents of the |
| 172 // buffer that's passed in. | 172 // buffer that's passed in. |
| 173 // Returns NULL if buffer is NULL. | 173 // Returns NULL if buffer is NULL. |
| 174 static BinaryValue* CreateWithCopiedBuffer(char* buffer, size_t size); | 174 static BinaryValue* CreateWithCopiedBuffer(const char* buffer, size_t size); |
| 175 | 175 |
| 176 ~BinaryValue(); | 176 ~BinaryValue(); |
| 177 | 177 |
| 178 // Subclassed methods | 178 // Subclassed methods |
| 179 Value* DeepCopy() const; | 179 Value* DeepCopy() const; |
| 180 virtual bool Equals(const Value* other) const; | 180 virtual bool Equals(const Value* other) const; |
| 181 | 181 |
| 182 size_t GetSize() const { return size_; } | 182 size_t GetSize() const { return size_; } |
| 183 char* GetBuffer() { return buffer_; } | 183 char* GetBuffer() { return buffer_; } |
| 184 const char* GetBuffer() const { return buffer_; } |
| 184 | 185 |
| 185 private: | 186 private: |
| 186 // Constructor is private so that only objects with valid buffer pointers | 187 // Constructor is private so that only objects with valid buffer pointers |
| 187 // and size values can be created. | 188 // and size values can be created. |
| 188 BinaryValue(char* buffer, size_t size); | 189 BinaryValue(char* buffer, size_t size); |
| 189 | 190 |
| 190 char* buffer_; | 191 char* buffer_; |
| 191 size_t size_; | 192 size_t size_; |
| 192 | 193 |
| 193 DISALLOW_COPY_AND_ASSIGN(BinaryValue); | 194 DISALLOW_COPY_AND_ASSIGN(BinaryValue); |
| (...skipping 177 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 371 virtual bool Serialize(const Value& root) = 0; | 372 virtual bool Serialize(const Value& root) = 0; |
| 372 | 373 |
| 373 // This method deserializes the subclass-specific format into a Value object. | 374 // This method deserializes the subclass-specific format into a Value object. |
| 374 // If the return value is non-NULL, the caller takes ownership of returned | 375 // If the return value is non-NULL, the caller takes ownership of returned |
| 375 // Value. If the return value is NULL, and if error_message is non-NULL, | 376 // Value. If the return value is NULL, and if error_message is non-NULL, |
| 376 // error_message should be filled with a message describing the error. | 377 // error_message should be filled with a message describing the error. |
| 377 virtual Value* Deserialize(std::string* error_message) = 0; | 378 virtual Value* Deserialize(std::string* error_message) = 0; |
| 378 }; | 379 }; |
| 379 | 380 |
| 380 #endif // BASE_VALUES_H_ | 381 #endif // BASE_VALUES_H_ |
| OLD | NEW |