mirror/v
1
0
Fork 0
mirror of https://github.com/vlang/v.git synced 2023-08-10 21:13:21 +03:00
Code Issues Projects Releases Wiki Activity

docs: fix incorrect struct literal and interface smart cast errors (#17457)

Browse Source
This commit is contained in:
Samuel Šulovský 2023-03-02 12:31:12 +01:00 committed by GitHub
parent e2daa84a33
commit 7497d8457f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
doc/docs.md
View File

@ -254,8 +254,8 @@ println('hello world')
``` ```
> **Note** > **Note**
> If you do not use explicitly `fn main() {}`, you need to make sure, that all your > If you do not explicitly use `fn main() {}`, you need to make sure that all your
> declarations, come before any variable assignment statements, or top level function calls, > declarations come before any variable assignment statements or top level function calls,
> since V will consider everything after the first assignment/function call as part of your > since V will consider everything after the first assignment/function call as part of your
> implicit main function. > implicit main function.
@ -2107,7 +2107,7 @@ mut p := Point{
y: 20 y: 20
} }
println(p.x) // Struct fields are accessed using a dot println(p.x) // Struct fields are accessed using a dot
// Alternative literal syntax for structs with 3 fields or fewer // Alternative literal syntax
p = Point{10, 20} p = Point{10, 20}
assert p.x == 10 assert p.x == 10
``` ```
@ -2171,7 +2171,7 @@ struct Foo {
All struct fields are zeroed by default during the creation of the struct. All struct fields are zeroed by default during the creation of the struct.
Array and map fields are allocated. Array and map fields are allocated.
In case of reference value, [see](#structs-with-reference-fields). In case of reference value, see [here](#structs-with-reference-fields).
It's also possible to define custom default values. It's also possible to define custom default values.
@ -2557,7 +2557,7 @@ are a function of their arguments only, and their evaluation has no side effects
Function arguments are immutable by default, even when [references](#references) are passed. Function arguments are immutable by default, even when [references](#references) are passed.
> **Note** > **Note**
> V is not a purely functional language however. > However, V is not a purely functional language.
There is a compiler flag to enable global variables (`-enable-globals`), but this is There is a compiler flag to enable global variables (`-enable-globals`), but this is
intended for low-level applications like kernels and drivers. intended for low-level applications like kernels and drivers.
@ -2611,6 +2611,10 @@ For this reason V doesn't allow the modification of arguments with primitive typ
Only more complex types such as arrays and maps may be modified. Only more complex types such as arrays and maps may be modified.
### Variable number of arguments ### Variable number of arguments
V supports functions that receive an arbitrary, variable amounts of arguments, denoted with the
`...` prefix.
Below, `a ...int` refers to an arbitrary amount of parameters that will be collected
into an array named `a`.
```v ```v
fn sum(a ...int) int { fn sum(a ...int) int {
@ -2745,9 +2749,10 @@ fn main() {
} }
``` ```
V currently does not guarantee, that it will print 100, 200, 300 in that order. V currently does not guarantee that it will print 100, 200, 300 in that order.
The only guarantee is that 600 (from the body of `f`), will be printed after all of them. The only guarantee is that 600 (from the body of `f`) will be printed after all of them.
That *may* change in V 1.0 .
This *may* change in V 1.0 .
## References ## References
@ -3265,7 +3270,7 @@ fn (c Cat) speak() string {
return 'meow' return 'meow'
} }
// unlike Go and like TypeScript, V's interfaces can define fields, not just methods. // unlike Go, but like TypeScript, V's interfaces can define both fields and methods.
interface Speaker { interface Speaker {
breed string breed string
speak() string speak() string
@ -3393,10 +3398,7 @@ fn main() {
dump(a) dump(a)
// In order to execute instances that implements IBar. // In order to execute instances that implements IBar.
if a is IBar { if a is IBar {
// a.bar() // Error. a.bar()
b := a as IBar
dump(b)
b.bar()
} }
} }
} }
@ -3593,7 +3595,7 @@ if mut w is Mars {
``` ```
Otherwise `w` would keep its original type. Otherwise `w` would keep its original type.
> This works for both, simple variables and complex expressions like `user.name` > This works for both simple variables and complex expressions like `user.name`
#### Matching sum types #### Matching sum types