Jump to content
php.lv forumi

turpinājums: no PHP funkciju komentāri


Grey_Wolf

Recommended Posts

  • Replies 73
  • Created
  • Last Reply

Top Posters In This Topic

manuprāt kodu jāraksta angliski jo :

normāli uzrakstītu klasi var izmantot citur - neatkarīgi no klienta tautības

komentārus, ja vien nav specefiskas prasības un tas nav starptautisks, jāraksta SEV ērtākā veidā ...

 

komentārus iztulkot ir sīkums, pretstatā klases manīgo pārakstīšnai

Link to comment
Share on other sites

Atbilde: programmēšanas valodas PHP ( arī C, Python, izRuby, u.c. ) vārdiskais pieraksts ir apakškopa no angļu valodas. Q.E.D.

Bet programmējot mēs šos vārdus nekādi neizmantojam valodas kontekstā - mēs nekonstruējam teikumus angļu valodā, tie ir tikai nosaukumi, kurus mēs izmantojam, bet konstrukcijas veidojam attiecīgi PHP, js, u.c. valodās.

Bet rakstot komentārus, mēs konstruējam teikumus attiecīgajā valodā (angļu, latviešu), komentāra mērķis ir cilvēkam saprotamā valodā aprakstīt to, ko, kā un kāpēc dara tālāk uzrakstītais kods.

Link to comment
Share on other sites

Koda elementus (mainīgos, funkcijas, klases) saukt angliski vajag tāpēc, ka citi koda elementi jau ir angliski un tur mums nav īpašas izvēles. Bet tas nekādi nenosaka to, ka komentārus, kas nav kods, bet ir lirisks koda apraksts, nevar/nevajag rakstīt mums vis ērtāk lietojamajā valodā.

Edited by codez
Link to comment
Share on other sites

Šos vārdus izmanto ļoti valodas kontekstā, jo zarošanās konstrukciju mēs pierakstām ar angļu "ja" jeb "if" un "citādi" jeb "else".

 

Tulkot komentārus, kad vajag klasi izmantot citur, ir lieks darbs, ja var neko netulkot, bet uzreiz uzrakstīt universāli saprotamā valodā.

 

Kā arī - dažādu valodu izmantošana kodā un komentārus prasa tulkot galvā vislaik, kad tiek lasīti komentāri un atbilstošais kods, lai saistītu vienā valodā sauktus mainīgo ar to aprakstu citā valodā. Vienā valodā šī liekā procedūra atkrīt.

Edited by Kavacky
Link to comment
Share on other sites

Tad jau sql varbūt paskāls vēl kaut cik turās līdzi valodas kontekstam, jo angliski teikums būtu

if a is greater than b then call function exit.

if ($a>$b) {exit();}

Viens if nepadara 2. pēkšņi par kaut kādu angļu valodas teikumu.

Edited by codez
Link to comment
Share on other sites

Kavacky: Ja, Logo tagad kļūtu par populārāko valodu, un darbā tev prasītu šo valodu zināt, tu komentārus šai valodai arī rakstītu vāciski, par cik koda elementi sastāv no vācu valodas?

Edited by y2ok
Link to comment
Share on other sites

Kā arī - dažādu valodu izmantošana kodā un komentārus prasa tulkot galvā vislaik, kad tiek lasīti komentāri un atbilstošais kods, lai saistītu vienā valodā sauktus mainīgo ar to aprakstu citā valodā. Vienā valodā šī liekā procedūra atkrīt.

Kas liek tulkot nosaukumus. Es, piemēram, nosaukumus netulkoju. Ja mainīgo sauc $user, tad tas ir mainīgā nosaukums un ir pilnīgi normāli nosaukumus netulkot.

Link to comment
Share on other sites

User - Lietotājs, member - biedrs. Mēs netulkojam, vienkārši paskaidrojam latviski, ko funkcija dara!

 

un ja kāds tomēr ir izdomājis, ka member jātulko kā lietotājs?

 

un vispār fuck it, I have already given too much fuck

Edited by spainis
Link to comment
Share on other sites

Ja mēs runājam par lietotāju kā aplikācijas lietotāju, tad saucam viņu par lietotāju, ja mēs runājam konkrēti par mainīgo $user, tad to saucam par $user. Ja mums ir 2 mainīgie $user un $member, tad tos tā arī saucam, ja mums ir kaut kādas kādas vairākas loģiskas vienības, tad atkarībā no konteksta tās tā arī saucam, piemēram



class user{
 /**
 *  Nosūtīt ziņu lietotājiem no šī lietotāja.
 *
 *  @param array $users Masīvs ar lietotāju id, kuriem sūtīt ziņu. Lietotāju id, kuri neeksistēs, tiks ignorēti.
 *  @param string $text Ziņas saturs. Tiek eskeipots funkcijā.
 */
 function sendMessage($users, $text){
 }
}

Kādas problēmas?

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...

×
×
  • Create New...