Every language has nuances. Sometimes they can be ignored, other times they get in the way, yet other times they lead to defects. Most disturbing are simple things that are missing, something that exists in another language, or something that seems like it'd be easy to implement. Perhaps it's just a minor syntax flaw, ambiguity, or library limitation.
What are the simple things in your favourite languages that give you grief on a regular basis?
Top comments (35)
The fact that, in Python, "joining an array using a given string" is phrased as "use this string to join an array".
Now I'm used to it, but I used to get it wrong all the time, because 'join' is an active verb, so at least for me it makes sense to put it after the thing being joined.
Yup, I get that wrong every time I attempt to join an array. Logically
join
should either be a part of the array type or a standalone function.I never understand why join is applying in separator passing the list to join them..
It's because the argument to
join
can be anything that you can iterate over e.g. list, tuple, array etc. Python tends to make functions take duck-typed arguments rather than having interface-style compatibility on types.In Python:
This leads to bugs when you're writing an array of strings. This happens to me especially often when writing Django
settings.py
filesThis sets ÌNSTALLED_APPS
to
["foo", "barbaz"]`. I wish this would throw a SyntaxError.C and C++ both do such string concatenation as well, though I've always considered it a feature. Put in this form it definitely will lead to unintended defects.
I wonder why it's there, given PYthon has string concatenation with a simple
+
.Because
is a syntax error, since the + doesn't make python join the lines. You'd have to do
Python is my all-time favorite language, but I absolutely HATE packaging, installing packages, and working with virtual environments in it.
I've been told
pip
is getting better, and perhaps it is a bit, but it's still quite hard to get quite the right combination of packages working in the right scopes.Thus why I've been saying for years: "Packaging in Python is like beating yourself to death with a wet trout." (So far, no Pythonista I've encountered has disagreed, even recently.)
Probably appropriate:
Definitely. I felt that I was really just randomly copy and pasting bits into a setup.py file to get my install working. I never have figured out what the correct way to generate documentation is.
Java Collections. Good stuff, but the API just didn't advance with time:
You never know for sure if your key is a valid parameter, even if your generics tell, which key type you want to use. Always
Object
.Want to create an
ArrayList
with one entry? Think this works?Nope, the constructor does not take items as parameter. Instead, use
Collections.singletonList
, but that one is immutable. Be surprised by your nextRuntimeException
. You could also useArrays.asList
, but not for a single item because that's considered inefficient.YES. This is very annoying.
They're not part of the core language and you probably already know about them, but for those who don't:
Google Guava has Lists: Lists.newArrayList(E... elements)
Implementation: github.com/google/guava/blob/maste...
And (of course) Kotlin has the lovely arrayListOf(...)
kotlinlang.org/api/latest/jvm/stdl...
Using both Elm and F#. Here are a few things that irk me.
Hazardous generics
Elm :
Result SomeErrorType SomeType
F# :
Result<SomeType, SomeErrorType>
- The sharp angles cut meElm union types do not allow an optional leading
|
, which makes the first one a pain to copy/paste, diff, etc. (Maybe implemented soon.)let
syntax is nicer to use. Elmlet
statements require anin
clause whereas it is optional/implicit in F#. Additionally, elm-format always expandslet
statements to multi-line. The visually-enormous resulting code leads you to want to avoidlet
in Elm.Here is what the last two lines would look like in C#.
[Delphi]
AnsiContainsStr
parameters order:Haystack, Needle
(documentation)AnsiPos
parameters order:Needle, Haystack
(documentation)This one has its share on me getting fired from a summer job, as I started shouting out loud in the office when I discovered it.
Vulgar APIs require vulgar outbursts. :)
Golang is one of my favorites, but writing the same thing over and over annoys me more than anything. I'm talking, of course, about:
Edit: I'm also aware that you can use named return types to do the simplified version below.
There should be a syntax shorthand for commonly used stuff like this. Rust has the
try!()
macro that does this, or even shorter, the?
operator.This is one of my core complaints about Go. I'm quite opposed to explicit error handling since ultimately coders will just forget it in places, or not check it correctly. I'm in favour of errors propagating by default, and having a nice option to catch them if you want.
Any repetition is syntax is bad for readability. The intent of the code gets lost in overhead.
I really love Scala, but
(also if you're programming half of the project in Java, "++" can confuse you, because it does different things in Java and Scala)
What don't you like about #2, that values can be returned without a return statement? Are they named returns in the function signature?
You somtime accidentally return values (method type = unit (so you don't have to return null and can't get a nullPointException)) and sometimes it can take a while to understand that something gets return (like when a function does return true if it did what it should and that gets returned by another function)
I despise the fact that
null
is an object in JavaScript.In Swift, it's often annoying that you cannot have a variable of a generic protocol type. You need to have a generic type implementing that protocol because you cannot specify associated types when declaring a variable.
For example, Swift has a Collection protocol, which has an associated generic type Element.
Instead of declaring a variable with
let foo: Collection<Int> = ...
you need to have a generic variableC: Collection where C.Element == Int
, which can be pretty annoying because your enclosing structures also need to be generic.Example
It would be so much more pleasant to write
Yes I am aware of the
AnyCollection<Element>
type but that is just a workaround that is specific to the collection protocol and not a general solution and yes I am aware that the Swift compiler always wants to specialize generics at compile time but this is just annoying.