C语言在代码哪些地方需要注释呢???越详细越好! 给一段C语言代码加注释,越详细越好

C\u8bed\u8a00\u57fa\u672c\u4ee3\u7801\uff0c\u6c42\u8be6\u7ec6\u89e3\u91ca\uff0c\u8d8a\u8be6\u7ec6\u8d8a\u597d\u3002

#include //\u5934\u6587\u4ef6\uff0c\u9884\u5904\u7406\u6587\u4ef6
#include"math.h"//\u6570\u5b66\u516c\u5f0f\u5934\u6587\u4ef6
double pcos(double a);//\u58f0\u660epcos\u51fd\u6570
main()//\u4e3b\u51fd\u6570
{double x,y;//\u5b9a\u4e49\u4e24\u4e2a\u53cc\u7cbe\u5ea6\u7684\u53d8\u91cf
printf("please input one number:");//\u8f93\u51fa
scanf("%lf",&x);//\u8f93\u5165x
y=pcos(x);//\u6267\u884c\u51fd\u6570pcos
printf("cos of %lf is %lf\n",x,y);//\u8f93\u51fa\u6267\u884cpcos\u4e4b\u524d\u548c\u4e4b\u540e\u7684\u503c}
double pcos(double a)//pcos\u51fd\u6570\u5b9a\u4e49
{double b;//\u5b9a\u4e49\u53cc\u7cbe\u5ea6\u53d8\u91cfb
b=cos(a);//\u83b7\u5f97a\u7684cos\u503c\uff0c\u5e76\u8d4b\u503c\u7ed9b
return b;\u8fd4\u56deb}
int main() //\u4e3b\u51fd\u6570
{ //\u5927\u82b1\u62ec\u53f7\u8868\u793a\u4e00\u6bb5\u6574\u7a0b\u5e8f
int a; //\u58f0\u660e\u53d8\u91cfa
int b; //\u58f0\u660e\u53d8\u91cfb
scanf("%d",&a); //\u8f93\u5165a
scanf("%d",&b); //\u8f93\u5165b
printf("result: %d",a+b); //\u6253\u5370\u51faa+b\u7684\u503c
printf("This time i will not say helloworld!");// \u6253\u5370\u4e00\u6bb5\u8bdd\uff0c\u4e2d\u95f4\u7528\u53cc\u5f15\u53f7\u201c\u201d\u8868\u793a\u8981\u6253\u5370\u7684\u5185\u5bb9
return 0; //\u5411\u4e3b\u51fd\u6570\u8fd4\u56de\u4e00\u4e2a0}

3.6.1 \u4ee3\u7801\u6ce8\u91ca

1. 注释不是越多越好。
2. 注释如果写不明白,或者和代码意思不一样,不如不写。
3. 尽可能采用代码自注释,即代码写得很明白,基本不用注释,一眼就能看明白。
4. 变量名和函数名尽量写得贴近生活,不需要注释。如果需要注释,先换个名字试试。实在无法从名字看出用途,再注释。
5. 一个函数或者一个类的有局限性,或者要说明用途时,用注释。
6. 当一个注释针对的代码有改动后,需要同步修改注释。

写代码注释的历程:几乎不注释 ---> 大量注释 ----> 关键注释。
建议学习一个好的写代码风格,需要注释才注释。

需要注释的地方一般是你自己定义的变量、函数等,还有一些不太好理解的算法可以注释一下便于后期代码的维护!

比如 AfxMessageBox("注释"); //这里是注释

一般都是这样注释的.

  • C璇█鍙橀噺鍛藉悕涓浠g爜娉ㄩ噴
    绛旓細鏈鍚庯紝瀵逛簬杈撳嚭鏍煎紡锛孧FC搴撴彁渚涗簡涓板瘜鐨勮鏄庯紝濡%d鐢ㄤ簬鏁存暟锛%s鐢ㄤ簬瀛楃涓诧紝%f鐢ㄤ簬娴偣鏁帮紝%c鐢ㄤ簬瀛楃銆傝繖浜涙牸寮忓寲鎸囦护鍦ㄤ唬鐮涓娇鐢ㄦ椂锛屽%d-%s锛岄兘鏄紑鍙戜汉鍛樼殑寰楀姏鍔╂墜銆傛荤殑鏉ヨ锛C璇█鐨勫彉閲忓懡鍚嶅拰浠g爜娉ㄩ噴鏄紪绋嬭瑷涓笉鍙垨缂虹殑鍏冪礌銆傞伒寰寛鐗欏埄鍛藉悕娉曪紝缁撳悎娓呮櫚鐨勬敞閲婏紝鑳借浠g爜鏃㈤珮鏁堝張鏄撲簬鐞嗚В...
  • C璇█缂栫▼鐨娉ㄩ噴绗﹀彿鏈夊摢鍑犵?
    绛旓細鏈変袱绉娉ㄩ噴鏂规硶锛// 琛屾敞閲婏紝鍙互娉ㄩ噴鍏跺悗鐨勪竴琛屻/* */ 鍧楁敞閲婏紝娉ㄩ噴杩欎袱涓鍙蜂腑闂寸殑鎵鏈夊尯鍩熴傘愰噴鐨勫師鍒欍戞敞閲婄殑鐩殑鏄В閲浠g爜鐨勭洰鐨勩佸姛鑳藉拰閲囩敤鐨勬柟娉曪紝鎻愪緵浠g爜浠ュ鐨勪俊鎭紝甯姪璇昏呯悊瑙d唬鐮侊紝闃叉娌″繀瑕佺殑閲嶅娉ㄩ噴淇℃伅銆 绀轰緥锛氬涓嬫敞閲婃剰涔変笉澶с/* if receive_flag is TRUE */ if (...
  • c璇█娉ㄩ噴鐨勪袱绉嶅舰寮
    绛旓細/* 杩欐槸涓涓琛娉ㄩ噴 鍙互鐢ㄦ潵娉ㄩ噴涓娈垫垨澶氳浠g爜 */ int sum = 1 + 2; // 璁$畻1鍜2鐨勫拰 鍦ㄤ笂闈㈢殑渚嬪瓙涓紝澶氳娉ㄩ噴鍖呭惈鍦“/*”鍜“*/”涔嬮棿锛屽苟鐢ㄤ簬娉ㄩ噴涓琛屼唬鐮併傞渶瑕佹敞鎰忕殑鏄紝C璇█缂栬瘧鍣ㄤ細蹇界暐鎺夋敞閲婁腑鐨勫唴瀹癸紝涓嶄細瀵瑰畠浠繘琛屼换浣曞鐞嗐侰璇█涓殑娉ㄩ噴鏈変袱绉...
  • c璇█涓娉ㄩ噴鐨勪綔鐢
    绛旓細涓鑸潵璁叉湁涓ょ锛氫竴鏄崟琛屾敞閲婏細鐩存帴鍦ㄨ琛闇瑕佹敞閲鐨鍦版柟鍔犱笂"//"灏辫浜嗐備緥濡傦細"int a,b;//杩欐槸涓涓敞閲婅"銆傞偅涔堬紝"//"鍚庨潰鐨勯儴鍒"杩欐槸涓涓敞閲婅"灏辫娉ㄩ噴鎺変簡锛屼笉璧蜂綔鐢紝浣嗘槸"//"鍓嶉潰鐨勨渋nt a,b;"涓嶅彈褰卞搷銆傚彟澶栬繕鏈変竴绉嶆槸澶氳鍚屾椂娉ㄩ噴锛/ int a,b;int c,d;/ 鍏朵腑"/*"...
  • C绋嬪簭娉ㄩ噴鏄敱浠涔鍜屼粈涔堟墍鐣屽畾鐨勬枃瀛椾俊鎭粍鎴愮殑
    绛旓細C绋嬪簭娉ㄩ噴鏄敱 \* 鍜 *\ 鎵鐣屽畾鐨勬枃瀛椾俊鎭粍鎴愮殑銆傚湪缂栧啓C璇█婧愪唬鐮鏃讹紝搴旇澶氫娇鐢ㄦ敞閲婏紝杩欐牱鏈夊姪浜庡浠g爜鐨勭悊瑙c傚湪C璇█涓湁涓ょ娉ㄩ噴鏂瑰紡锛1銆佷竴绉嶆槸浠/*寮濮嬨佷互*/缁撴潫鐨勫潡娉ㄩ噴锛坆lock comment锛夛紱2銆佸彟涓绉嶆槸浠//寮濮嬨佷互鎹㈣绗︾粨鏉熺殑鍗曡娉ㄩ噴锛坙ine comment锛夈傚彲浠ヤ娇鐢/*鍜*/鍒嗛殧绗︽潵...
  • C璇█娉ㄩ噴鏂瑰紡鏈鍝簺?
    绛旓細绛旓細鍦ㄧ敤C璇█缂栫▼鏃讹紝甯哥敤鐨娉ㄩ噴鏂瑰紡鏈夊涓嬪嚑绉嶏細锛1锛夊崟琛屾敞閲 //鈥︼紙2锛夊琛屾敞閲 /*鈥*/ 锛3锛夋潯浠剁紪璇戞敞閲 #if 0鈥#endif
  • 璇峰憡璇夊府杩欎簺C璇█璇彞鍔犱笂娉ㄩ噴!璋㈣阿!鏈汉鏄垵瀛!
    绛旓細for(b=0;b<10;b++)//寰幆璇彞 锛岀涓涓弬鏁版槸鍒濆鐨勬潯浠讹紝绗簩涓弬鏁版槸缁堟鐨勬潯浠讹紝绗 //涓変釜鏉′欢琛ㄧず鐨勬槸 b 杩欎釜鍊煎湪姣忔瘡寰幆涓娆 灏变細鍔1 { scanf("%d",&a[b]);//鐢ㄦ潵杈撳叆鐨凜鍑芥暟 "%_" 杩欎釜鍙傛暟琛ㄧず鐨勬槸 浣犺杈撳叆鐨勬暟鎹殑 //绫诲瀷锛 鍦ㄨ繖閲 "%d" 琛ㄧず鐨勬槸 浣犺...
  • C璇█绋嬪簭缂栬瘧鏃剁▼搴忎腑鐨娉ㄩ噴閮ㄥ垎鏄惁鍙傚姞缂栬瘧?
    绛旓細鍙互鍙傚姞銆傛墍璋撴敞閲婏紝渚挎槸鐢ㄨ嚜鐒璇█瀵规簮浠g爜涓煇浜涜鍙ユ垨鏂规硶杩涜璇存槑銆傚苟涓旀敞閲婄殑鍐呭涓嶄細琚紪璇戝櫒缂栬瘧銆傚彲浠鍦ㄦ簮浠g爜涓坊鍔犱换浣曟兂瑕佹坊鍔犵殑璇存槑銆傛敞閲婂彲浠ュ嚭鐜鍦ㄤ唬鐮涓殑浠讳綍浣嶇疆锛岀敤鏉ュ悜鐢ㄦ埛鎻愮ず鎴栬В閲婁唬鐮佺殑鍚箟銆傜▼搴忕紪璇戞椂锛屼細蹇界暐娉ㄩ噴锛屼笉鍋氫换浣曞鐞嗭紝灏卞ソ鍍忓畠涓嶅瓨鍦ㄤ竴鏍枫傚闇瑕佹敞閲鐨勫唴瀹规瘮杈冨锛...
  • c璇█绋嬪簭鐨娉ㄩ噴鏄互浠涔寮澶翠粈涔堢粨鏉
    绛旓細2銆佸琛娉ㄩ噴锛氬琛屾敞閲婁互/寮澶达紝浠/缁撳熬銆傜紪璇戝櫒浼氬拷鐣ヨ繖涓や釜绗﹀彿涔嬮棿鐨勬墍鏈夋枃鏈傚琛屾敞閲婇氬父鐢ㄤ簬鎻愪緵鏇磋缁嗙殑璇存槑鎴栬В閲婏紝浠ュ強绀轰緥浠g爜銆備緥濡傦細*/锛#include<stdio.h>int main锛堬級{/*鍦ㄨ繖閲岀紪鍐欎竴涓畝鍗曠殑杈撳嚭璇彞*/printf锛圚ello锛學orld锛乗n锛夛紱return0锛泒銆C璇█鐨勫簲鐢細1銆佺郴缁熷紑鍙戯細C璇█...
  • c璇█濡備綍娉ㄩ噴?
    绛旓細娉ㄩ噴瑙i噴浜嗚繖涓彲閫夊弬鏁扮殑鐢ㄦ硶锛歩nt open( const char *name, int mode, 鈥 /* int permissions */ )锛浠g爜鍏锋湁杈冨ソ鐨勫彲绉绘鎬 C璇█鏄潰鍚戣繃绋嬬殑缂栫▼璇█锛岀敤鎴峰彧闇瑕佸叧娉ㄦ墍琚В鍐抽棶棰樼殑鏈韩锛岃屼笉闇瑕佽姳璐硅繃澶氱殑绮惧姏鍘讳簡瑙g浉鍏崇‖浠讹紝涓旈拡瀵逛笉鍚岀殑纭欢鐜锛屽湪鐢–璇█瀹炵幇鐩稿悓鍔熻兘鏃剁殑浠g爜鍩烘湰涓鑷...
  • 扩展阅读:c++入门程序代码 ... c语言必背100代码 ... c语言代码生成器 ... c语言怎么一键注释 ... c++必背入门代码 ... c语言如何快速注释 ... 黑客编程必背50个代码 ... 初学编程必背50个 ... c语言如何实现一键注释 ...

    本站交流只代表网友个人观点,与本站立场无关
    欢迎反馈与建议,请联系电邮
    2024© 车视网