@@ -43,7 +43,7 @@ optional chaining etc.
43
43
````
44
44
✅ Array.append.Array.Int?
45
45
✅ Flatten.Array.Tuple4.for-in.reserved
46
- ✅ OCB .NSArray.as!.Array.NSString
46
+ ✅ Bridging .NSArray.as!.Array.NSString
47
47
````
48
48
49
49
Note: Special characters that could be interpreted by the shell require escaping
@@ -97,16 +97,15 @@ Use periods to separate the name components in variants derived from specialised
97
97
generic types or significant method chains.
98
98
99
99
````
100
- ⛔️ InsertCharacterStartIndex
101
100
⛔️ InsertCharacterTowardsEndIndexNonASCII
102
101
````
103
102
104
103
There's no need to be literal with type names. ** Be descriptive** :
105
104
106
105
````
107
- ✅ Flatten.Array.Tuple4.lazy.flatMap
108
- ✅ String.insert.ASCIIChar.StartIndex
109
106
✅ String.insert.EmojiChar.NearEnd
107
+ ✅ String.insert.ASCIIChar.StartIndex
108
+ ✅ Flatten.Array.Tuple4.lazy.flatMap
110
109
````
111
110
112
111
</details ><p ><!-- spacer --> </p ></li >
@@ -129,18 +128,16 @@ Use **`Val`** and **`Ref`** as short descriptors for variants that compare value
129
128
types (` struct ` , ` Int ` ) with reference types (often named with ` Class ` in the
130
129
legacy-style).
131
130
Prefer ** ` Char ` ** to ` Character ` , which can be combined with codepage or
132
- language prefix/suffix when necessary (` ASCIIChar ` ). For benchmarks that measure
133
- ` String ` 's Unicode performance for various languages, use
131
+ language prefix/suffix when necessary (` EmojiChar ` , ` ASCIIChar ` ). For benchmarks
132
+ that measure ` String ` 's Unicode performance for various languages, use
134
133
[ two letter codes] ( https://en.wikipedia.org/wiki/ISO_639-1 ) instead of spelling
135
134
out the whole language names.
136
135
137
- * In a pinch* , it's OK to use short C-style naming prefixes like ` OCB ` (for
138
- Objective-C Bridging) or consistent abbreviations in the benchmark family like
139
- ` Str ` and ` Arr ` , but * only if* it helps to fit a system with descriptive
140
- names into 40 characters:
136
+ When necessary, use * consistent* abbreviations like ` Str ` and ` Arr ` within the
137
+ benchmark family, to fit a system with descriptive names into 40 characters:
141
138
142
139
````
143
- ✅ OCB .NSDict.as!.Dictionary .NSString.NSNum
140
+ ✅ Bridging .NSDict.as!.Dict .NSString.NSNum
144
141
✅ Seq.prefixWhile.AnySeq.UnfoldSeq.lazy
145
142
````
146
143
0 commit comments