Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(104)

Side by Side Diff: base/values.h

Issue 17047: Update some comments/nits following r7486. (Closed) Base URL: svn://chrome-svn/chrome/trunk/src/
Patch Set: '' Created 11 years, 11 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
« no previous file with comments | « base/json_reader.cc ('k') | chrome/common/json_value_serializer.h » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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 303 matching lines...) Expand 10 before | Expand all | Expand 10 after
314 // Note that the list always owns the Value passed out via out_value. 314 // Note that the list always owns the Value passed out via out_value.
315 bool Get(size_t index, Value** out_value) const; 315 bool Get(size_t index, Value** out_value) const;
316 316
317 // Convenience forms of Get(). Modifies value (and returns true) only if 317 // Convenience forms of Get(). Modifies value (and returns true) only if
318 // the index is valid and the Value at that index can be returned in 318 // the index is valid and the Value at that index can be returned in
319 // the specified form. 319 // the specified form.
320 bool GetDictionary(size_t index, DictionaryValue** out_value) const; 320 bool GetDictionary(size_t index, DictionaryValue** out_value) const;
321 321
322 // Removes the Value with the specified index from this list. 322 // Removes the Value with the specified index from this list.
323 // If |out_value| is non-NULL, the removed Value AND ITS OWNERSHIP will be 323 // If |out_value| is non-NULL, the removed Value AND ITS OWNERSHIP will be
324 // passed out via out_value. If |out_value| is NULL, the removed value will 324 // passed out via |out_value|. If |out_value| is NULL, the removed value will
325 // be deleted. This method returns true if |index| is valid; otherwise 325 // be deleted. This method returns true if |index| is valid; otherwise
326 // it will return false and the ListValue object will be unchanged. 326 // it will return false and the ListValue object will be unchanged.
327 bool Remove(size_t index, Value** out_value); 327 bool Remove(size_t index, Value** out_value);
328 328
329 // Appends a Value to the end of the list. 329 // Appends a Value to the end of the list.
330 void Append(Value* in_value); 330 void Append(Value* in_value);
331 331
332 // Iteration 332 // Iteration
333 typedef ValueVector::iterator iterator; 333 typedef ValueVector::iterator iterator;
334 typedef ValueVector::const_iterator const_iterator; 334 typedef ValueVector::const_iterator const_iterator;
(...skipping 23 matching lines...) Expand all
358 virtual bool Serialize(const Value& root) = 0; 358 virtual bool Serialize(const Value& root) = 0;
359 359
360 // This method deserializes the subclass-specific format into a Value object. 360 // This method deserializes the subclass-specific format into a Value object.
361 // If the return value is non-NULL, the caller takes ownership of returned 361 // If the return value is non-NULL, the caller takes ownership of returned
362 // Value. If the return value is NULL, and if error_message is non-NULL, 362 // Value. If the return value is NULL, and if error_message is non-NULL,
363 // error_message should be filled with a message describing the error. 363 // error_message should be filled with a message describing the error.
364 virtual Value* Deserialize(std::string* error_message) = 0; 364 virtual Value* Deserialize(std::string* error_message) = 0;
365 }; 365 };
366 366
367 #endif // BASE_VALUES_H_ 367 #endif // BASE_VALUES_H_
OLDNEW
« no previous file with comments | « base/json_reader.cc ('k') | chrome/common/json_value_serializer.h » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698