commit 0c1989589a3ab82216fcbfabe16111fc89e86988
parent fe096bf93990a770a5ab0f5664ec84dc2687eb54
Author: David Eisinger <[email protected]>
Date: Sun, 16 Jul 2023 23:12:15 -0400
Add go map note; tweak complex UL styles
Diffstat:
2 files changed, 29 insertions(+), 15 deletions(-)
diff --git a/content/notes/golang/index.md b/content/notes/golang/index.md
@@ -97,15 +97,15 @@ I find [Go][1] really compelling, even though it's not super applicable to my jo
* For case-insensitive matching, start the expression with `(?i)`
* [Unnamed parameters][17]
-> Unnamed parameters are perfectly valid. The [Parameter declaration](https://golang.org/ref/spec#ParameterDecl) from the spec:
->
-> ```
-> ParameterDecl = [ IdentifierList ] [ "..." ] Type .
-> ````
->
-> As you can see, the `IdentifierList` (the identifier name or names) is in square brackets, which means it's _optional_. Only the `Type` is required.
->
-> The reason for this is because the names are not really important for someone calling a method or a function. What matters is the types of the parameters and their order. This is detailed in this answer: [Getting method parameter names in Golang](https://stackoverflow.com/questions/31377433/getting-method-parameter-names-in-golang/31377793#31377793)
+ > Unnamed parameters are perfectly valid. The [Parameter declaration](https://golang.org/ref/spec#ParameterDecl) from the spec:
+ >
+ > ```
+ > ParameterDecl = [ IdentifierList ] [ "..." ] Type .
+ > ````
+ >
+ > As you can see, the `IdentifierList` (the identifier name or names) is in square brackets, which means it's _optional_. Only the `Type` is required.
+ >
+ > The reason for this is because the names are not really important for someone calling a method or a function. What matters is the types of the parameters and their order. This is detailed in this answer: [Getting method parameter names in Golang](https://stackoverflow.com/questions/31377433/getting-method-parameter-names-in-golang/31377793#31377793)
* [Named result parameters][18]
* Type Conversion & Assertion
@@ -114,17 +114,21 @@ I find [Go][1] really compelling, even though it's not super applicable to my jo
* `switch v := i.(type) {` (case per type, `v` is `i` cast to that type)
* [Custom error types][19]
-> Usually, a struct is used to create a custom error type. By convention, custom error type names should end with `Error`. Also, it is best to set up the `Error() string` method with a pointer receiver, see this [Stackoverflow comment](https://stackoverflow.com/a/50333850) to learn about the reasoning. Note that this means you need to return a pointer to your custom error otherwise it will not count as `error` because the non-pointer value does not provide the `Error() string` method.
+ > Usually, a struct is used to create a custom error type. By convention, custom error type names should end with `Error`. Also, it is best to set up the `Error() string` method with a pointer receiver, see this [Stackoverflow comment](https://stackoverflow.com/a/50333850) to learn about the reasoning. Note that this means you need to return a pointer to your custom error otherwise it will not count as `error` because the non-pointer value does not provide the `Error() string` method.
* [Maps][20]
-> A Go map type looks like this: `map[KeyType]ValueType`
+ > A Go map type looks like this: `map[KeyType]ValueType`
-> To initialize a map, use the built in `make` function: `m = make(map[string]int)`
+ > To initialize a map, use the built in `make` function: `m = make(map[string]int)`
-> This statement retrieves the value stored under the key `"route"` and assigns it to a new variable i: `i := m["route"]`. If the requested key doesn’t exist, we get the value type’s _zero value_. In this case the value type is `int`, so the zero value is `0`.
+ > This statement retrieves the value stored under the key `"route"` and assigns it to a new variable i: `i := m["route"]`. If the requested key doesn’t exist, we get the value type’s _zero value_. In this case the value type is `int`, so the zero value is `0`.
-> A two-value assignment tests for the existence of a key: `i, ok := m["route"]`
+ > A two-value assignment tests for the existence of a key: `i, ok := m["route"]`
+
+ * [Insertion order has no effect on the order keys/values are retrieved in a `range` query][21]
+
+ > The iteration order over maps is not specified and is not guaranteed to be the same from one iteration to the next.
* First-class functions
* Go supports first-class functions (functions as arguments and return values of other functions)
@@ -144,3 +148,4 @@ I find [Go][1] really compelling, even though it's not super applicable to my jo
[18]: https://go.dev/doc/effective_go#named-results
[19]: https://exercism.org/tracks/go/concepts/errors
[20]: https://go.dev/blog/maps
+[21]: https://go.dev/ref/spec#RangeClause
diff --git a/themes/v2/assets/css/style.scss b/themes/v2/assets/css/style.scss
@@ -46,6 +46,16 @@ ul {
text-indent: -2ch;
}
}
+
+ blockquote {
+ p:first-child {
+ text-indent: 0;
+ }
+
+ pre {
+ text-indent: 0;
+ }
+ }
}
}
@@ -54,7 +64,6 @@ ol {
padding: 0;
}
-
blockquote {
border-left: 1ch solid #ddd;
font-style: italic;
