1.這是我看某文檔的時(shí)候產(chǎn)生的疑問,如一個(gè)node中的write方法:
buf.write(string[, offset[, length]][, encoding])
2.問題:函數(shù)參數(shù)中的中括號(hào)代表什么了?怎么有些只有半個(gè)括號(hào),比如string[ 或 offset[;而有的卻是length]][這樣了?
3.還會(huì)有其他符號(hào)也有它獨(dú)特代表的含義嗎?
4.這種寫法的好處是什么?
以上三個(gè)問題作一個(gè)問題回答。
簡(jiǎn)單的回答就是中括號(hào)表示這個(gè)參數(shù)非必須.
接下來詳細(xì)解釋。
首先,這樣使用中括號(hào)只是出于一種的表達(dá)形式的需要而已(這樣的表達(dá)形式很常見),這與api本身是沒有關(guān)系的。
然后,我們拿上面的例子來說
buf.write(string[, offset[, length]][, encoding])
對(duì)于buf.write
這個(gè)方法:
第一個(gè)參數(shù)string
是必須的,他表示你要寫入的內(nèi)容;往后的offset
、length
、encoding
這些參數(shù)都是非必須的。這些參數(shù)你可以不傳(用[]括起來表示不傳),但并不表示這三個(gè)參數(shù)你想怎么傳就怎么傳的,這里是有規(guī)則的,規(guī)則從這里中括號(hào)的對(duì)應(yīng)關(guān)系中可以看出來。我們來看他的對(duì)應(yīng)關(guān)系:[, offset[, length]]
&& [ encoding]
。這表示offset
、length
和encoding
你可以傳或者不傳,但是你要是沒有傳offset
的話那length
是一定不能傳的,這就是為什么length
要放在offset
的括號(hào)里面的原因。
所以整個(gè)例子理解起來就是:string
必須傳,offset
、length
、encoding
可傳可不傳,但是offset
不傳的話length
也不能傳。
至于這樣寫有什么好處,我想這可能是當(dāng)初寫api那幫家伙覺得這樣表達(dá)更合理吧,后面寫文檔的覺得這種方式還不錯(cuò),就依葫蘆畫瓢了,慢慢的就約定俗成了。
北大青鳥APTECH成立于1999年。依托北京大學(xué)優(yōu)質(zhì)雄厚的教育資源和背景,秉承“教育改變生活”的發(fā)展理念,致力于培養(yǎng)中國(guó)IT技能型緊缺人才,是大數(shù)據(jù)專業(yè)的國(guó)家
北大青鳥中博軟件學(xué)院創(chuàng)立于2003年,作為華東區(qū)著名互聯(lián)網(wǎng)學(xué)院和江蘇省首批服務(wù)外包人才培訓(xùn)基地,中博成功培育了近30000名軟件工程師走向高薪崗位,合作企業(yè)超4
中公教育集團(tuán)創(chuàng)建于1999年,經(jīng)過二十年潛心發(fā)展,已由一家北大畢業(yè)生自主創(chuàng)業(yè)的信息技術(shù)與教育服務(wù)機(jī)構(gòu),發(fā)展為教育服務(wù)業(yè)的綜合性企業(yè)集團(tuán),成為集合面授教學(xué)培訓(xùn)、網(wǎng)
達(dá)內(nèi)教育集團(tuán)成立于2002年,是一家由留學(xué)海歸創(chuàng)辦的高端職業(yè)教育培訓(xùn)機(jī)構(gòu),是中國(guó)一站式人才培養(yǎng)平臺(tái)、一站式人才輸送平臺(tái)。2014年4月3日在美國(guó)成功上市,融資1
曾工作于聯(lián)想擔(dān)任系統(tǒng)開發(fā)工程師,曾在博彥科技股份有限公司擔(dān)任項(xiàng)目經(jīng)理從事移動(dòng)互聯(lián)網(wǎng)管理及研發(fā)工作,曾創(chuàng)辦藍(lán)懿科技有限責(zé)任公司從事總經(jīng)理職務(wù)負(fù)責(zé)iOS教學(xué)及管理工作。
浪潮集團(tuán)項(xiàng)目經(jīng)理。精通Java與.NET 技術(shù), 熟練的跨平臺(tái)面向?qū)ο箝_發(fā)經(jīng)驗(yàn),技術(shù)功底深厚。 授課風(fēng)格 授課風(fēng)格清新自然、條理清晰、主次分明、重點(diǎn)難點(diǎn)突出、引人入勝。
精通HTML5和CSS3;Javascript及主流js庫(kù),具有快速界面開發(fā)的能力,對(duì)瀏覽器兼容性、前端性能優(yōu)化等有深入理解。精通網(wǎng)頁制作和網(wǎng)頁游戲開發(fā)。
具有10 年的Java 企業(yè)應(yīng)用開發(fā)經(jīng)驗(yàn)。曾經(jīng)歷任德國(guó)Software AG 技術(shù)顧問,美國(guó)Dachieve 系統(tǒng)架構(gòu)師,美國(guó)AngelEngineers Inc. 系統(tǒng)架構(gòu)師。