mirror
/
go
mirror of https://github.com/golang/go.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

net: document concurrency safety and example for Dialer 

Fixes #33743.

Change-Id: I80621321d56b6cf312a86e272800f1ad03c5544c
GitHub-Last-Rev: d91cb36975
GitHub-Pull-Request: golang/go#33856
Reviewed-on: https://go-review.googlesource.com/c/go/+/191879
Run-TryBot: Emmanuel Odeke <emm.odeke@gmail.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com>
This commit is contained in:
tomocy 2019-09-02 14:34:16 +00:00 committed by Emmanuel Odeke
parent 03ac39ce5e
commit 2f04903fec
2 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/net/dial.go
View File

@ -23,6 +23,8 @@ const (
// The zero value for each field is equivalent to dialing // The zero value for each field is equivalent to dialing
// without that option. Dialing with the zero value of Dialer // without that option. Dialing with the zero value of Dialer
// is therefore equivalent to just calling the Dial function. // is therefore equivalent to just calling the Dial function.
//
// It is safe to call Dialer's methods concurrently.
type Dialer struct { type Dialer struct {
// Timeout is the maximum amount of time a dial will wait for // Timeout is the maximum amount of time a dial will wait for
// a connect to complete. If Deadline is also set, it may fail // a connect to complete. If Deadline is also set, it may fail

18
src/net/example_test.go
View File

@ -5,10 +5,12 @@
package net_test package net_test
import ( import (
"context"
"fmt" "fmt"
"io" "io"
"log" "log"
"net" "net"
"time"
) )
func ExampleListener() { func ExampleListener() {
@ -37,6 +39,22 @@ func ExampleListener() {
} }
} }
func ExampleDialer() {
var d net.Dialer
ctx, cancel := context.WithTimeout(context.Background(), time.Minute)
defer cancel()
conn, err := d.DialContext(ctx, "tcp", "localhost:12345")
if err != nil {
log.Fatalf("Failed to dial: %v", err)
}
defer conn.Close()
if _, err := conn.Write([]byte("Hello, World!")); err != nil {
log.Fatal(err)
}
}
func ExampleIPv4() { func ExampleIPv4() {
fmt.Println(net.IPv4(8, 8, 8, 8)) fmt.Println(net.IPv4(8, 8, 8, 8))