1
0
mirror of https://github.com/golang/go synced 2024-11-18 06:54:49 -07:00

net/url: document Parse more

That Parse doesn't parse ("foo.com/path" or "foo.com:443/path") has
become something of a FAQ.

Updates #19779
Updates #21415
Updates #22955

Change-Id: Ib68efddb67f59b1374e8ed94effd4a326988dee7
Reviewed-on: https://go-review.googlesource.com/81436
Reviewed-by: Ian Lance Taylor <iant@golang.org>
This commit is contained in:
Brad Fitzpatrick 2017-12-01 17:00:58 +00:00
parent 22b4c83585
commit ea0d2c14f8

View File

@ -441,7 +441,11 @@ func split(s string, c string, cutc bool) (string, string) {
}
// Parse parses rawurl into a URL structure.
// The rawurl may be relative or absolute.
//
// The rawurl may be relative (a path, without a host) or absolute
// (starting with a scheme). Trying to parse a hostname and path
// without a scheme is invalid but may not necessarily return an
// error, due to parsing ambiguities.
func Parse(rawurl string) (*URL, error) {
// Cut off #frag
u, frag := split(rawurl, "#", true)