Convention: Choosing the best english names for functions and keywords declaration

Question

4.50/5 (2 votes)

See more:

Hello,
I want to know if there is a convention about choosing the best English names for functions and keywords declaration.
I spend many time to make a decision to name a function or a keyword in C or C++ programming, because my English is poor and there are many synonyms in English.
Of course there are Boolean names that begins with Is or Can or Has or any other Boolean expression.
What to choose when there are synonym words (ie. Display and Show) !?

Thank you for your understanding

Posted 17-Sep-12 8:18am

Mr. Tomay

Updated 17-Sep-12 8:20am

v2

Add a Solution

3 solutions

Solution 1

I often just contract a short sentence...

Example:

C++

size_t NumberOfFilesProcessed;

If I come back to this code after a long absence, it's still clear exactly what the variable is intended to represent.

Posted 17-Sep-12 8:20am

JackDingler

Comments

Shaunak De 18-Sep-12 11:42am

I follow this approach :)
A little typing today saves a lot of hair tomorrow!

Solution 2

Wiki[^] is always helpfull ;)

Posted 17-Sep-12 9:30am

Maciej Los

Add a Solution

Add your solution here

Treat my content as plain text, not as HTML

Preview 0

…

Existing Members

Sign in to your account

...or Join us

Download, Vote, Comment, Publish.

Your Email
Password
Forgot your password?

Your Email
This email is in use. Do you need your password?
Optional Password

I have read and agree to the Terms of Service and Privacy Policy
Please subscribe me to the CodeProject newsletters

When answering a question please:

Read the question carefully.
Understand that English isn't everyone's first language so be lenient of bad spelling and grammar.
If a question is poorly phrased then either ask for clarification, ignore it, or edit the question and fix the problem. Insults are not welcome.
Don't tell someone to read the manual. Chances are they have and don't get it. Provide an answer or move on to the next question.

Let's work to help developers, not make them feel stupid.

This content, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

CPallini · Accepted Answer · 2012-09-17T10:17:00

Solution 3

I think:

You are not alone (many of us have the same problem).
Both display and show could make sense (I suppose some libraries use the former while others use the latter). This is a typical scenario, because synonyms are, well, synonyms...

Posted 17-Sep-12 10:17am

CPallini

Comments

Maciej Los 17-Sep-12 16:41pm

I like this answer, because it's... friendly in every single aspect. And the best is on the end ;)

+5!

CPallini 18-Sep-12 3:13am

Thank you.