toml: update readme with value_opt() usage (#14569)
							parent
							
								
									d2b097fbf8
								
							
						
					
					
						commit
						2ab6ef7f0a
					
				|  | @ -79,6 +79,10 @@ To query for a value that might not be in the document you | |||
| can use the `.default_to(...)` function to provide a | ||||
| default value. | ||||
| 
 | ||||
| For cases where a default value might not be appropiate or | ||||
| to check if a value exists you can use `doc.value_opt('query')?` | ||||
| instead. | ||||
| 
 | ||||
| ```v | ||||
| import toml | ||||
| 
 | ||||
|  | @ -100,8 +104,15 @@ assert doc.value('table.array[0].a').string() == 'A' | |||
| // Provides a default value | ||||
| assert doc.value('non.existing').default_to(false).bool() == false | ||||
| 
 | ||||
| // Check if value exist | ||||
| // doc.value_opt('should.exist') or { ... } | ||||
| // or | ||||
| if value := doc.value_opt('table.array[1].b') { | ||||
| 	assert value.string() == 'B' | ||||
| } | ||||
| 
 | ||||
| // You can pass parts of the TOML document around | ||||
| // and still use .value() to get the values | ||||
| // and still use .value()/.value_opt() to get the values | ||||
| arr := doc.value('table.array') | ||||
| assert arr.value('[1].b').string() == 'B' | ||||
| ``` | ||||
|  |  | |||
		Loading…
	
		Reference in New Issue