It has come to my attention that most of the people that learn how to program in highschool \/ college \/ university have bad habbits when it comes to writing their code down.
\nI’m not saying the code itself is incorrect, i’m pretty sure they teach the correct stuff, but i’m talking about other things that usually get ignored…
\nIn order to program effectively, it’s important that you keep to a set of rules.
\nThe ones that irritate me the most are:<\/p>\n
Okay, most of the time code written by people that don’t really have an interest in coding, but just take those classes because “they have to do something to get a diploma” looks like this:<\/p>\n
\n<\/p>\n
\r\n\/\/ PHP Variable Naming example\r\n$mystring = \"Hello World!\";\r\n$myarray = array(\"item1\", \"item2\", \"item3\", \"item4\");\r\n$mynumber = 1;\r\n$mybool = true;\r\n\r\n\/\/ Output: Hello World! My array holds 4 items, my number is 1 and this all is 1\r\nprintf(\"$mystring My array holds \".count($myarray).\" items, my number is $mynumber and this all is $mybool
\");\r\n\r\n\/** Output:\r\n* item1\r\n* item2\r\n* item3\r\n* item4 **\/\r\nforeach($myarray as $item){\r\nprintf($item.\"
\");\r\n}\r\n<\/pre>\n\nNow imagine that part of code x 2000.
\nI know i’ve used pretty obvious variable names, like mystring<\/i> which indicates it’s a string etc, but i could’ve used any other name such as “$dog”<\/i> where you won’t know what type the variable really is.
\nI mean, it could be a string where you define the dog name, or the dog type,
\nbut it could also be a integer or a boolean: dog = true (yes, it’s a dog) or dog = 4 (A certain pre-defined dog type or whatever).<\/p>\nAnyhow, back ontopic:<\/p>\n
If I would be working at a company with a programming team, and one of my team members would send me a large file filled with code and variables names like that, i’d spent more time figuring out what type what variable is.<\/p>\n
That’s why it’s important that you make sure that people can tell by the name of your variable what type is stored inside the variable.
\nWhen I was learning OO in PHP, i’ve forced myself to keep using this set of standards, and i’ve been using them in all my programs since then in all the coding languages i know (PHP, Java, VB.NET, NASC, …)<\/p>\nAccording to the Hungarian Naming Convention all variable names should be built as following:<\/p>\n
I’ll show you a quick example of a class in PHP:<\/p>\n
\r\n\t\/\/ Organized example\r\n\tclass Foo\r\n\t{\r\n\t\tprotected $m_sName;\r\n\t\tprotected $m_nAge;\r\n\r\n\t\tpublic function getInfo( $p_bAge )\r\n\t\t{\r\n\t\t\t\/\/ Show name with age or without age\r\n\t\t\tif( $p_bAge == true )\r\n\t\t\t{\r\n\t\t\t\tprintf( $this->m_sName.\" is \".$this->m_nAge.\" years old!\" );\r\n\t\t\t}\r\n\t\t\telse\r\n\t\t\t{\r\n\t\t\t\tprintf($this->m_sName.\" doesn't want to show his\/her age!\");\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n<\/pre>\nAs you can see, i’ve used my own standards and anyone that knows PHP and reads this code will know exactly what kind of value is inside each variable.
\nI hope you’ve also noticed that i’ve indent my code, including the make-up for the if-else etc<\/p>\n
The basic idea behind indent is to have a much better overview of your code, it’ll be easier to determine what belongs to where.
\nLet’s say we got the above code, but I won’t indent it nor make it pretty:<\/p>\n
\r\n\/\/ Organized example\r\nclass Foo\r\n{\r\nprotected $m_sName;\r\nprotected $m_nAge;\r\n\r\npublic function getInfo( $p_bAge )\r\n{\r\n\/\/ Show name with age or without age\r\nif( $p_bAge == true ){\r\nprintf( $this->m_sName.\" is \".$this->m_nAge.\" years old!\" );\r\n}else{\r\nprintf($this->m_sName.\" doesn't want to show his\/her age!\");}\r\n}\r\n}\r\n<\/pre>\nNow imagine that again x 2000.
\nI’ll bet you $100 USD you’ll get confused before you’ve read through the first 100 lines of the code \ud83d\ude1b<\/p>\n
In cases like these, it’s not easy to determine which closing tag belongs to which opening tag, unless you’re using a special software to write your code in (Notepad++ for example highlights start & ending tags if you click on them)<\/p>\n
Bottom line is: use correct names and learn to ident your code, make a habbit out of it!<\/p>\n","protected":false},"excerpt":{"rendered":"
It has come to my attention that most of the people that learn how to program in highschool \/ college \/ university have bad habbits when it comes to writing their code down. I’m not saying the code itself is incorrect, i’m pretty sure they teach the correct stuff, but i’m talking about other things … Continue reading Coding standards<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[38,6],"tags":[],"_links":{"self":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts\/19"}],"collection":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=19"}],"version-history":[{"count":3,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts\/19\/revisions"}],"predecessor-version":[{"id":791,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts\/19\/revisions\/791"}],"wp:attachment":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=19"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=19"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=19"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}