版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進行舉報或認領(lǐng)
文檔簡介
計算機源代碼編寫規(guī)范Ver2.1P-PAGE6/6沈陽東大阿爾派軟件股份有限公司計算機源代碼編寫規(guī)范文件編號:NW506104生效日期:2023.3.20受控編號:密級:秘密版次:Ver2.1修改狀態(tài):總頁數(shù)6正文6附錄0馬云生袁淮孟莉沈陽東大阿爾派軟件股份(版權(quán)所有,翻版必究)
文件修改控制修改記錄編號修改狀態(tài)修改頁碼及條款修改人審核人批準(zhǔn)人修改日期
目錄1. 目的2. 適用范圍3. 術(shù)語及縮略語4. 規(guī)范內(nèi)容標(biāo)識符命名及書寫規(guī)范注釋規(guī)則縮進規(guī)則計算機源代碼編寫規(guī)范Ver2.1P-PAGE4/6沈陽東大阿爾派軟件股份有限公司目的良好的編程風(fēng)格是提高程序可靠性非常重要的手段,也是大型項目多人合作開發(fā)的技術(shù)基礎(chǔ)。本規(guī)范的目的在于通過規(guī)范定義來避免不好的編程風(fēng)格,增強程序的易讀性,便于自己和其它程序員理解。適用范圍本規(guī)定適用于所有軟件的源程序編寫??蛻粲刑厥庖髸r,則遵循客戶提出的要求。對于移植性開發(fā)或低版本的升級開發(fā),則按照前一版本的格式要求。術(shù)語及縮略語本程序采用NQ402100《質(zhì)量手冊》中的術(shù)語和縮略語及其定義。規(guī)范內(nèi)容4.1 標(biāo)識符命名及書寫規(guī)則4.1.1 基本規(guī)則1) 這里的標(biāo)識符是指編程語言中語法對象的名字,它們有常量名、變量名、函數(shù)名、類和類型名、文件名等,標(biāo)識符的基本語法是以字母開始,由字母數(shù)字及下劃線組成的單詞。標(biāo)識符本身最好能夠表明其自身的含義,以便于使用和他人閱讀。按其在應(yīng)用中的含義由一個或多個詞組成??梢允怯⑽脑~或中文拼音詞。當(dāng)標(biāo)識符由多個詞組成時,每個詞的第一個字母大寫,其余全部小寫,常量標(biāo)識符全部大寫。中文詞由中文描述含義的每個漢字的頭一個拼音字母組成。英文詞盡量不縮寫,如果有縮寫,在同一系統(tǒng)中對同一單詞必須使用相同的表示法。標(biāo)識的總長度不要超過32個字符。4.1.2 特殊約定有的編程工具或項目開發(fā)小組對標(biāo)識符的命名有自己的規(guī)定,例如,把標(biāo)識符分為兩部分:規(guī)范標(biāo)識前綴+含義標(biāo)識規(guī)范標(biāo)識前綴用來標(biāo)明該標(biāo)識的歸類特征,以便與其它類型的標(biāo)識互相區(qū)別,例如:字符串變量標(biāo)識符的前綴為str,某字符串變量可命名為:strExample;文本框?qū)ο髽?biāo)識符的前綴為txt,某文本框?qū)ο蟮拿蔀椋簍xtExample;含義標(biāo)識用來標(biāo)明該標(biāo)識所對應(yīng)的被抽象的實體,以便記憶,上面例子中“strExample”的“Example”就是含義標(biāo)識。編程工具或項目開發(fā)小組有特殊約定的,以他們的約定為準(zhǔn)。3 源代碼文件標(biāo)識符命名規(guī)則源代碼文件標(biāo)識符分為兩部分,即文件名前綴和后綴。格式、規(guī)則如下:×××……××.×××前綴部分通常與該文件所表示的內(nèi)容或作用有關(guān)??梢杂身椖拷M成員統(tǒng)一約定。后綴部分通常表示該文件的類型,可以自己給定,具體的編程環(huán)境有特殊規(guī)定的以編程環(huán)境的規(guī)定為準(zhǔn)。前綴和后綴這兩部分字符應(yīng)僅使用字母、數(shù)字和下劃線。文件標(biāo)識的長度不能超過32個字符,以便于識別。4.2 注釋及格式要求注釋總是加在程序的需要一個概括性說明或不易理解或易理解錯的地方。注釋應(yīng)語言簡煉、易懂而又準(zhǔn)確,所采用的語種首選是中文,如有輸入困難、編譯環(huán)境限制或特殊需求也可采用英文。4.2.1 源代碼文件的注釋1) 在文件的頭部必須標(biāo)明程序名稱,它所完成的主要功能。2) 文件的作者,及完成時間。3) 階段測試結(jié)束后,主要修改活動的修改人、時間、簡單原因說明列表。4) 維護過程中需要修改程序時,應(yīng)在被修改語句前面注明修改時間和原因說明。4.2.2 函數(shù)或過程的注釋1) 在函數(shù)頭部必須對函數(shù)進行功能和參數(shù)(值參、變參)說明;2) 在函數(shù)的主體部分,如算法復(fù)雜時,應(yīng)以注釋的方式對其算法結(jié)構(gòu)作出說明;3) 函數(shù)申請過全局資源且有可能導(dǎo)致資源緊張應(yīng)加以注明(如內(nèi)存,文件柄等);4) 函數(shù)有副作用一定以十分醒目的方式(如加!號等)注明;5) 函數(shù)的長度在100語句行以內(nèi)(不包括注釋),程序有特殊要求時(如速度要求等)可以例外。4.2.3 語句的注釋1) 應(yīng)對不易理解的分支條件表達式加注釋;2) 不易理解的循環(huán),應(yīng)說明出口條件(有GOTO的程序還應(yīng)說明入口條件);3) 過長的函數(shù)實現(xiàn),應(yīng)將其語句按實現(xiàn)的功能分段加以概括性說明;4) 供別的文件或函數(shù)調(diào)用的函數(shù),絕不應(yīng)使用全局變量交換數(shù)據(jù)。4.2.4 常量和變量的注釋在常量名字(或有宏機制的語言中的宏)聲明后應(yīng)對該名字作適當(dāng)注釋,注釋說明的要點是:被保存值的含義(必須);合法取值的范圍(可選);全局量需要對以上逐點做充分的說明。4.3 縮進規(guī)則4.3.1 控制結(jié)構(gòu)的縮進程序應(yīng)以縮進形式展現(xiàn)程序的塊結(jié)構(gòu)和控制結(jié)構(gòu),在不影響展示程序結(jié)構(gòu)的前提下盡可能地減少縮進的層次。采用如下兩種縮進方式之一:1)2)if(expression){statements}else{statements}if(expression){statements}else{statements}4.3.2 縮進的限制一個程序的寬度如果超出頁寬或屏寬,這將是很難讀的,所以本規(guī)范要求使用折行縮進的方法、合并表達式或編寫子程序的方法來限制程序的寬度。1)任何一個程序最大行寬不得超過80列,超過者應(yīng)折行書寫。2)建議一個函數(shù)的縮進不得超過5級,超過者應(yīng)將其子塊寫為子函數(shù);3)算法或程序本身的特性有特殊要求時,可以超過5級。
供應(yīng)商調(diào)查管理制度總則1.1制定目的為了解供應(yīng)商之制程能力、品管功能,確認其是否有提供符合成本、交期、品質(zhì)之物料的能力,特制定本規(guī)章。1.2適用范圍對擬開發(fā)供應(yīng)商之調(diào)查,及本公司合格供應(yīng)商之年度復(fù)查,除另有規(guī)定外,悉依本規(guī)章辦理。1.3權(quán)責(zé)單位采購部負責(zé)本規(guī)章制定、修改、廢止之起草工作??偨?jīng)理負責(zé)本規(guī)章制定、修改、廢止之核準(zhǔn)。供應(yīng)商調(diào)查作業(yè)規(guī)定2.1供應(yīng)商調(diào)查程序采購部實施采購前,應(yīng)對擬開發(fā)之廠商組織供應(yīng)商調(diào)查工作,目的是了解供應(yīng)商之各項管理能力,以確定其可否列為合格供應(yīng)商名列。由采購、生技、品管、生管人員組成供應(yīng)商調(diào)查小組,對供應(yīng)商實施調(diào)查評核,并填寫《供應(yīng)商調(diào)查表》。評核之結(jié)果由各單位作出建議,供總經(jīng)理核定是否準(zhǔn)予成為本公司之合格供應(yīng)商。未經(jīng)供應(yīng)商調(diào)查認可之廠商,除總經(jīng)理特準(zhǔn)外,不可成為本公司之供應(yīng)商。2.2供應(yīng)商調(diào)查評核2.2.1價格評核對供應(yīng)商所提供之物料價格,由采購部依下列因素作評核:原料價格。加工費用。估價方法。付款方式。2.2.2技術(shù)評核對供應(yīng)商之生產(chǎn)技術(shù),由生技部依下列因素作評核:技術(shù)水準(zhǔn)。技術(shù)資料管理。設(shè)備狀況。工藝流程與作業(yè)標(biāo)準(zhǔn)。2.2.3品質(zhì)評核對供應(yīng)商之品質(zhì),由品管部依下列因素作評核:品管組織與體系。品質(zhì)規(guī)范與標(biāo)準(zhǔn)。檢驗之方法與記錄。糾正與預(yù)防措施。2.2.4生管評核對供應(yīng)商之生產(chǎn)管理,由生管部依下列因素作主核:生產(chǎn)計劃體系。最短及最長之交貨期限。進度控制方法。異常排除能力。2.3供應(yīng)商復(fù)查規(guī)定經(jīng)調(diào)查認可之合格供應(yīng)商,原則上每年復(fù)查一次。復(fù)查流程類同首次調(diào)查評核。復(fù)查不合格之供應(yīng)商,除經(jīng)本公司總經(jīng)理特準(zhǔn)外,不可列入次年合格供應(yīng)商之列。若供應(yīng)商之交期、品質(zhì)、價格或服務(wù)產(chǎn)生重大變異時,可于一年中,隨時對供應(yīng)商作必要之復(fù)查。附件[附件]GA02-1《供應(yīng)商調(diào)查表(范例)》
供應(yīng)商調(diào)查表(范例)年月日供應(yīng)商編號供應(yīng)商名稱調(diào)查時
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負責(zé)。
- 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- GB/T 6495.7-2025光伏器件第7部分:光伏器件測量的光譜失配修正計算方法
- 貨運車輛黑名單制度
- 財務(wù)會計準(zhǔn)則制度
- 落實備案審查年度工作報告制度
- 2026福建南平市建陽區(qū)文化體育和旅游局招聘1人參考考試試題附答案解析
- 2026黑龍江雙鴨山公益性崗位招聘176人參考考試試題附答案解析
- 上海市執(zhí)法類公務(wù)員招錄體能測評健康承諾書備考考試題庫附答案解析
- 2026上半年云南事業(yè)單位聯(lián)考能源職業(yè)技術(shù)學(xué)院招聘21人參考考試題庫附答案解析
- 2026四川廣安市廣安區(qū)白市鎮(zhèn)人民政府選用片區(qū)紀檢監(jiān)督員1人備考考試題庫附答案解析
- 2026年云南師范大學(xué)基礎(chǔ)教育集團人才招聘(若干)參考考試題庫附答案解析
- 2025年國家能源局系統(tǒng)公務(wù)員面試模擬題及備考指南
- 脊柱感染護理
- 2025年安徽省中考化學(xué)真題及答案
- 危險品押運證考試題及答案
- 2025年黨建工作應(yīng)試題庫及答案
- 痤瘡皮膚護理常規(guī)
- 2025-2030中國自動分板設(shè)備自動PCB分板設(shè)備行業(yè)運行態(tài)勢與投資前景預(yù)測報告
- 2025年陜西省中考英語試卷(含解析)
- 2025至2030中國海綿新材料行業(yè)市場發(fā)展現(xiàn)狀及商業(yè)模式與投資發(fā)展報告
- 《三級醫(yī)院評審標(biāo)準(zhǔn)(2025年版)》
- 急診成人社區(qū)獲得性肺炎臨床實踐指南(2024 年版)解讀
評論
0/150
提交評論