OLD | NEW |
1 // Copyright (c) 2010 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2010 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 intended for | 5 // This file specifies a recursive data storage class called Value intended for |
6 // storing setting and other persistable data. It includes the ability to | 6 // storing setting and other persistable data. It includes the ability to |
7 // specify (recursive) lists and dictionaries, so it's fairly expressive. | 7 // specify (recursive) lists and dictionaries, so it's fairly expressive. |
8 // However, the API is optimized for the common case, namely storing a | 8 // However, the API is optimized for the common case, namely storing a |
9 // hierarchical tree of simple values. Given a DictionaryValue root, you can | 9 // hierarchical tree of simple values. Given a DictionaryValue root, you can |
10 // easily do things like: | 10 // easily do things like: |
(...skipping 314 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
325 bool GetListWithoutPathExpansion(const std::string& key, | 325 bool GetListWithoutPathExpansion(const std::string& key, |
326 ListValue** out_value) const; | 326 ListValue** out_value) const; |
327 /*DEPRECATED*/bool GetWithoutPathExpansion(const std::wstring& key, | 327 /*DEPRECATED*/bool GetWithoutPathExpansion(const std::wstring& key, |
328 Value** out_value) const; | 328 Value** out_value) const; |
329 /*DEPRECATED*/bool GetIntegerWithoutPathExpansion(const std::wstring& key, | 329 /*DEPRECATED*/bool GetIntegerWithoutPathExpansion(const std::wstring& key, |
330 int* out_value) const; | 330 int* out_value) const; |
331 /*DEPRECATED*/bool GetStringWithoutPathExpansion( | 331 /*DEPRECATED*/bool GetStringWithoutPathExpansion( |
332 const std::wstring& key, std::string* out_value) const; | 332 const std::wstring& key, std::string* out_value) const; |
333 /*DEPRECATED*/bool GetStringWithoutPathExpansion( | 333 /*DEPRECATED*/bool GetStringWithoutPathExpansion( |
334 const std::wstring& key, std::wstring* out_value) const; | 334 const std::wstring& key, std::wstring* out_value) const; |
335 /*DEPRECATED*/bool GetDictionaryWithoutPathExpansion( | |
336 const std::wstring& key, DictionaryValue** out_value) const; | |
337 /*DEPRECATED*/bool GetListWithoutPathExpansion(const std::wstring& key, | |
338 ListValue** out_value) const; | |
339 | 335 |
340 // Removes the Value with the specified path from this dictionary (or one | 336 // Removes the Value with the specified path from this dictionary (or one |
341 // of its child dictionaries, if the path is more than just a local key). | 337 // of its child dictionaries, if the path is more than just a local key). |
342 // If |out_value| is non-NULL, the removed Value AND ITS OWNERSHIP will be | 338 // If |out_value| is non-NULL, the removed Value AND ITS OWNERSHIP will be |
343 // passed out via out_value. If |out_value| is NULL, the removed value will | 339 // passed out via out_value. If |out_value| is NULL, the removed value will |
344 // be deleted. This method returns true if |path| is a valid path; otherwise | 340 // be deleted. This method returns true if |path| is a valid path; otherwise |
345 // it will return false and the DictionaryValue object will be unchanged. | 341 // it will return false and the DictionaryValue object will be unchanged. |
346 bool Remove(const std::string& path, Value** out_value); | 342 bool Remove(const std::string& path, Value** out_value); |
347 /*DEPRECATED*/bool Remove(const std::wstring& path, Value** out_value); | 343 /*DEPRECATED*/bool Remove(const std::wstring& path, Value** out_value); |
348 | 344 |
(...skipping 158 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
507 // This method deserializes the subclass-specific format into a Value object. | 503 // This method deserializes the subclass-specific format into a Value object. |
508 // If the return value is non-NULL, the caller takes ownership of returned | 504 // If the return value is non-NULL, the caller takes ownership of returned |
509 // Value. If the return value is NULL, and if error_code is non-NULL, | 505 // Value. If the return value is NULL, and if error_code is non-NULL, |
510 // error_code will be set with the underlying error. | 506 // error_code will be set with the underlying error. |
511 // If |error_message| is non-null, it will be filled in with a formatted | 507 // If |error_message| is non-null, it will be filled in with a formatted |
512 // error message including the location of the error if appropriate. | 508 // error message including the location of the error if appropriate. |
513 virtual Value* Deserialize(int* error_code, std::string* error_str) = 0; | 509 virtual Value* Deserialize(int* error_code, std::string* error_str) = 0; |
514 }; | 510 }; |
515 | 511 |
516 #endif // BASE_VALUES_H_ | 512 #endif // BASE_VALUES_H_ |
OLD | NEW |