mirror of
https://github.com/vlang/v.git
synced 2025-09-13 14:32:26 +03:00
docs: put some more dots in the doc comments of public APIs, found by find_doc_comments_with_no_dots.v
This commit is contained in:
parent
3271c728d5
commit
30ce22866d
6 changed files with 13 additions and 12 deletions
|
@ -107,7 +107,7 @@ fn C.cJSON_free(voidptr)
|
|||
|
||||
//
|
||||
|
||||
// version returns the version of cJSON as a string
|
||||
// version returns the version of cJSON as a string.
|
||||
pub fn version() string {
|
||||
return unsafe { tos3(&char(C.cJSON_Version())) }
|
||||
}
|
||||
|
|
|
@ -436,8 +436,8 @@ pub fn (f []Any) str() string {
|
|||
return Any(f).json_str()
|
||||
}
|
||||
|
||||
// str returns the string representation of the `Any` type. Use the `json_str` method
|
||||
// if you want to use the escaped str() version of the `Any` type.
|
||||
// str returns the string representation of the `Any` type. Use the `json_str` method.
|
||||
// If you want to use the escaped str() version of the `Any` type.
|
||||
pub fn (f Any) str() string {
|
||||
if f is string {
|
||||
return f
|
||||
|
|
|
@ -326,7 +326,7 @@ pub fn (f Any) to_time() !time.Time {
|
|||
}
|
||||
}
|
||||
|
||||
// map_from convert a struct to map of Any
|
||||
// map_from converts a struct to a map of Any.
|
||||
pub fn map_from[T](t T) map[string]Any {
|
||||
mut m := map[string]Any{}
|
||||
$if T is $struct {
|
||||
|
|
|
@ -37,7 +37,7 @@ pub struct Token {
|
|||
col int // the column in the source where the token occurred
|
||||
}
|
||||
|
||||
// full_col returns the full column information which includes the length
|
||||
// full_col returns the full column information which includes the length.
|
||||
pub fn (t Token) full_col() int {
|
||||
return t.col + t.lit.len
|
||||
}
|
||||
|
|
|
@ -21,7 +21,7 @@ pub:
|
|||
superfluous []string
|
||||
}
|
||||
|
||||
// strict_check
|
||||
// strict_check .
|
||||
pub fn strict_check[T](json_data string) StructCheckResult {
|
||||
// REVIEW how performatic is it?
|
||||
$if T is $struct {
|
||||
|
@ -112,7 +112,7 @@ fn get_keys_from_[T]() []string {
|
|||
return struct_keys
|
||||
}
|
||||
|
||||
// get_keys_from_json
|
||||
// get_keys_from_json .
|
||||
pub fn get_keys_from_json(tokens []string) []KeyStruct {
|
||||
mut key_structs := []KeyStruct{}
|
||||
|
||||
|
|
|
@ -2,7 +2,7 @@ module json2
|
|||
|
||||
import time
|
||||
|
||||
// `Any` is a sum type that lists the possible types to be decoded and used.
|
||||
// Any is a sum type that lists the possible types to be decoded and used.
|
||||
// `Any` priority order for numbers: floats -> signed integers -> unsigned integers
|
||||
// `Any` priority order for strings: string -> time.Time
|
||||
pub type Any = []Any
|
||||
|
@ -23,21 +23,22 @@ pub type Any = []Any
|
|||
| u8
|
||||
| Null
|
||||
|
||||
// Decodable is an interface, that allows custom implementations for decoding structs from JSON encoded values
|
||||
// Decodable is an interface, that allows custom implementations for decoding structs from JSON encoded values.
|
||||
pub interface Decodable {
|
||||
from_json(f Any)
|
||||
}
|
||||
|
||||
// Decodable is an interface, that allows custom implementations for encoding structs to their string based JSON representations
|
||||
// Encodable is an interface, that allows custom implementations for encoding structs to their string based JSON representations.
|
||||
pub interface Encodable {
|
||||
json_str() string
|
||||
}
|
||||
|
||||
// `Null` struct is a simple representation of the `null` value in JSON.
|
||||
// Null is a simple representation of the `null` value in JSON.
|
||||
pub struct Null {
|
||||
is_null bool = true
|
||||
}
|
||||
|
||||
// null is an instance of the Null type, to ease comparisons with it.
|
||||
pub const null = Null{}
|
||||
|
||||
// ValueKind enumerates the kinds of possible values of the Any sumtype.
|
||||
|
@ -49,7 +50,7 @@ pub enum ValueKind {
|
|||
number
|
||||
}
|
||||
|
||||
// str returns the string representation of the specific ValueKind
|
||||
// str returns the string representation of the specific ValueKind.
|
||||
pub fn (k ValueKind) str() string {
|
||||
return match k {
|
||||
.unknown { 'unknown' }
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue