[Powered by Google Translate] ამ ვიდეო, ჩვენ განვიხილავთ კოდი სტილი, რაც
რომ არის ახლოს და ძვირფასო ჩემს გულში.
სტილი აღწერილია, თუ როგორ თქვენი კოდი დაფორმატდა, რომელიც
დამოუკიდებელი რა კოდი რეალურად აკეთებს.
არა მარტო იქნება კარგი სტილის მისაღებად თქვენ უკეთესი Grade წელს CS50,
მაგრამ ეს ასევე დაეხმარება წერთ კოდი, რომელიც გაცილებით
იკითხება და maintainable, რომელიც, იმ დღის ბოლოს,
აპირებს თქვენი ცხოვრება ბევრი ადვილია.
>> სამი ძირითადი კომპონენტია კოდი სტილი, რომ ჩვენ განვიხილავთ
ეს ვიდეო არის კომენტარები, გაფორმებით,
და ცვალებადი სახელები.
დავიწყოთ კომენტარები.
გახსოვდეთ, კომენტარი არ აქვთ გავლენა
ფუნქციონალური თქვენი კოდი.
ისინი მხოლოდ გახდეს გამოსადეგი მინიშნებები ჩვენთვის, როგორც პროგრამისტები.
კარგი კომენტარი უნდა უპასუხოს ერთ ორ კითხვას.
>> პირველი, რას ბლოკი კოდი გავაკეთო?
ეს არის მოკლე და ტკბილი აღწერა მიზნით
ხაზები, რომ დაიცვას.
მაგალითად, თქვენ ალბათ საჭიროა, რათა იპოვოს ადგილი, სადაც თქვენ
განხორციელებული განსაკუთრებული თვისება დაფიქსირება
bug ან ცვლილება რაღაც.
გარეშე კომენტარი, თქვენ შეიძლება დაგჭირდეთ ფორე მეტი ბევრი ხაზები
კოდი ცდილობს გაერკვნენ რაში რომ ფუნქცია.
თუ ეს უკვე რამდენიმე დღის შემდეგ თქვენ შევხედე ერთი
თქვენი პროგრამების, თქვენ ალბათ არ გახსოვთ რა კონკრეტული
ფუნქცია ან loop აკეთებს.
ამიტომ კომენტარი გახდის reacquainting თავს ერთად
ძველი კოდი, ან მიგვეცა თავს ერთად სხვისი
კოდი, ბევრად გამარტივებას.
მეორე საკითხია კარგი კომენტარი პასუხი არის რატომ
განახორციელოს ამ ბლოკის ამ გზით?
როგორც წერთ კოდი, თქვენ ხშირად გვჭირდება
რათა დიზაინის გადაწყვეტილებები.
უნდა გამოვიყენო ხოლო მარყუჟი ან ამისთვის loop აქ?
უნდა მე ამ ბლოკის კოდი შევიდა ცალკე ფუნქცია?
გამოყენება კომენტარი, თქვენ დაამტკიცებთ თქვენი დიზაინი
გადაწყვეტილებები, რომელიც გახდის თქვენს კოდი ადვილია მესმის
სხვებისთვის, რომელსაც შეიძლება სვამს თვითონ ზუსტად იგივე
დიზაინი კითხვები, როგორც ისინი ისე იკითხება თქვენი კოდი.
ან თუნდაც საკუთარ თავს, თუ დაბრუნდება ბლოკი კოდი შემდეგ
ზოგიერთი ვადით.
>> In C, და სხვა ენებზე ვნახავთ წელს CS50, არის
ორი გზა დასძინა კომენტარი თქვენი კოდი, in-line კომენტარი
და მრავალ ხაზის კომენტარები.
In-ხაზის კომენტარის დიდი დოკუმენტირება ცალი კოდი
ფარგლებში ფუნქციები.
მაგალითად, წელს ხაზის კომენტარის შეიძლება აღწერს
მიზნით ამისთვის მარყუჟი ან კუთხეში შემთხვევაში, აუცილებელია
მდგომარეობა.
Multi-ხაზის კომენტარის დიდი დოკუმენტირება ფუნქციები.
როდესაც ვწერთ ფუნქციას, თქვენ ყოველთვის უნდა, ყოველთვის,
ყოველთვის დოკუმენტირება, თუ რას აკეთებს ერთად კომენტარი.
ეს მოიცავს, თუ რა საშუალებებით იმ ფუნქციის, რისი გაკეთებაც
გამომავალი ფუნქციის არის, და იქნებ რატომ ფუნქცია
განხორციელდა ისე, რომ ის არის.
როდესაც თქვენ შეცვალოს ფუნქცია ხელმოწერის, დააბრუნოს
ღირებულება, ან შესრულების, მნიშვნელოვანია ასევე განაახლებს
შესაბამისი დოკუმენტაცია კომენტარი.
Mismatch შორის ფუნქცია მისი კომენტარი და
განხორციელების შეიძლება მართლაც დამაბნეველი მკითხველისთვის.
ანალოგიურად, შექმნა მრავალ ხაზის კომენტარის ზედა
ყოველი. გ ან. თ ფაილის წერთ, სადაც აღწერილია, თუ რა
ფაილი ამჯამად, ასევე ძალიან კარგი იდეა.
>> როგორც თქვენ კომენტირებისას თქვენი კოდი, ერთერთი პირველი შეკითხვებს
ალბათ არის, ასევე, რამდენი უნდა კომენტარის ჩემი კოდი?
ეს ხშირად არასაჭირო დოკუმენტურად ყველა
ერთი ხაზი კოდი.
მაგალითად, ხაზი, რომელიც ამბობს int x = 5 არ სჭირდება
კომენტარის შესახებ, რომელიც ამბობს, "მითითებული x დან 5".
არ კომენტირებისას საკმარისი, თუმცა, როგორც ჩვენ ვნახეთ, შეუძლია
გაგება თქვენი კოდი ძალიან რთულია.
ასე რომ კარგი უზენაესობის ცერის არის კომენტარის საინტერესო ბლოკები
კოდი, სადაც ბლოკის შედგება რამდენიმე დაკავშირებული ხაზები.
>> მოდით შევხედოთ მაგალითს.
აქ uncommented C ფუნქცია.
Okay, რადგან ეს არის ფუნქცია, პირველი რაც გვჭირდება დაამატოთ
არის კომენტარი აეხსნა რა ფუნქციას მისი საშუალებებით
და რა ეს იმას.
მოდით დაამატოთ მრავალ ხაზის კომენტარი.
დიდი.
ახლა ჩვენ ვიცით, ზუსტად რა არის ჩვენი ფუნქცია არ.
მოდით დაამატოთ ზოგიერთი ხაზი კომენტარი ახლა.
ჩვენ შეგვიძლია ყოფს ჩვენს კოდი შევიდა ორი ბლოკის მსგავსი ხაზები.
ხაზები 4 და 5 შენება სიმები ეფუძნება შეყვანის და
ხაზები 6 გავლით 9 გამომავალი იმ
სიმები ფარგლებში ლირიკული სიმღერები.
მოდით დოკუმენტი, რომელიც კომენტარით.
გასაოცარია.
ახლა ჩვენი ფუნქცია გამოეხმაურა.
>> გაითვალისწინეთ, რომ ჩვენი in-line კომენტარი არ უნდა გამოვიყენოთ სრული
სასჯელი ან მთავრდება პერიოდში.
მნიშვნელოვანია, რომ არსებობს სივრცის შორის მეორე ხაზი
და დაწყების კომენტარი.
ეს არის სიხშირე კომენტარები განმავლობაში თქვენი პროგრამები
რომ თქვენ უნდა სროლა ამისთვის.
გაითვალისწინეთ აქ როგორ გამოვყავით ორი ბლოკის დაკავშირებული კოდი
შიგნით ჩვენი გუნდი ფუნქციის ზედმეტი ვაგონი დაბრუნების.
>> ეს მოაქვს, მომდევნო კომპონენტი კოდი სტილი,
გაფორმებით.
როდესაც მე პირველად დაიწყო პროგრამირების, მე დააჭირეთ
გასაღები ძალიან იშვიათად, რის შედეგადაც გიგანტი, unreadable
Blobs კოდი.
ვფიქრობ, რეალურად განაწყენებული ჩემი სწავლების თანამემამულე, რადგან
არ იყო ძალიან კმაყოფილი ვარ.
ვიზუალურად დაჯგუფება ბლოკები დაკავშირებული კოდი გამოყენებით ვაგონი
ანაზღაურება, შეგიძლიათ თქვენი კოდი ადვილია skim და ნათლად
გაიმიჯნოს რომელიც ხაზების კოდი თქვენი კომენტარი არიან ხსნიდა.
რომ მიმდინარეობს განაცხადა, გავრცელების თქვენი კოდი ძალიან ბევრი, როგორც
ორი ან მეტი ხაზების შორის კოდი ბლოკებად ან ფუნქციებს, შეიძლება
ასევე იგი გაცილებით ნაკლებია იკითხება.
>> წანაცვლება არის კიდევ ერთი მნიშვნელოვანი
ასპექტი კოდი ფორმატში.
ყოველთვის, ყოველთვის, ყოველთვის აბზაცის ორგანოს ფუნქცია, მარყუჟის,
ან მდგომარეობა.
ეს ცხადყოფს, რომელიც ხაზების კოდი არის შიგნით
მარყუჟის, მაგალითად, და რომელიც ხაზების კოდი
არიან გარეთ რომ.
CS50 ურჩევს, რომ თქვენ აბზაცის ოთხი ფართები, მაგრამ
თუ თქვენ აირჩევთ რაღაც, დარწმუნებული უნდა იყოს, უნდა იყოს თანმიმდევრული
მთელ თქვენს კოდი.
იმ შენიშვნა, CS50 ურჩევს, რომ თქვენ მიიტანეთ braces
საკუთარი ხაზი.
რომ გზა, braces იქნება გამოდიან ვიზუალურად ამავე მარცხენა
ზღვარი, ამიტომ ნათელია, სადაც ბლოკის იწყება და მთავრდება.
თუმცა, ასევე, okay განვათავსოთ braces იმავე ხაზის
მდგომარეობა, მაგალითად, შენარჩუნებას სივრცეში.
თუ ამის გაკეთება, თუმცა, დარწმუნდით მოიცავს სივრცეში
ადრე Curly გაუწიოს ამიტომ არ smooshed შემდეგ დახურვის
PAREN ან სიტყვას.
>> რომელი აირჩიოთ, ყველაზე მნიშვნელოვანი ის არის, რომ იყოს
თანმიმდევრული მთელი თქვენი კოდი.
რა არ გვინდა ვიხილოთ, თუმცა, არის
indented Curly braces.
ამით ხდის braces წელს გათიშული საწყისი
მდგომარეობა, მარყუჟის, ან ფუნქცია ისინი demarcating, რაც
კოდი მძიმე წასაკითხი.
In C და სხვა ენებზე ვნახავთ, Curly braces are
სურვილისამებრ ერთი ხაზი პირობები ან მარყუჟების.
ეს ჯარიმა უნდა გამომრჩეს Curly braces ამ შემთხვევაში, მაგრამ თუ
ასე, დარწმუნებული უნდა იყოს, უნდა იყოს თანმიმდევრული
მთელ თქვენს კოდი.
>> როდესაც განმსაზღვრელი ფუნქციები, CS50 რეკომენდაციას თქვენ დაწერა
დაბრუნების ტიპის ფუნქციას იმავე ხაზის სახელით
ფუნქცია.
თუმცა, ასევე, OK დაწერა დაბრუნების ტიპის საკუთარი
ხაზი, რომელიც შეუძლია ფუნქციის განმარტებები ადვილია იპოვით
რაიმე ტექსტი რედაქტორები.
>> და ბოლოს, დარწმუნდით მასში ფართების გარშემო
სიტყვა და ოპერატორები.
მაგალითად, ხაზი, რომელიც ამბობს int x = 5 გაცილებით ადვილია,
წაიკითხა თუ არსებობს ფართების გარშემო თანაბარი ნიშანი.
ანალოგიურად, დარწმუნდით აქვს სივრცეში შემდეგ საკვანძო სიტყვები მინდა, თუ,
ამისთვის, ხოლო.
გარეშე სივრცე, ეს შეიძლება გამოიყურებოდეს ფუნქცია მოუწოდებს,
რომლის შემდეგაც ისინი.
>> მოდით შევხედოთ მაგალითად გამოყენების კარგი სტილი
რათა მძიმედ ფორმატირებული ბლოკი კოდი.
Okay, დავიწყოთ ყველაზე.
ჩვენ ვხედავთ, რომ გახსნის გაუწიოს ძირითადი არის იმავე
ხაზის ფუნქციას სახელი.
თუ ჩვენ ვაპირებთ ამის გაკეთებას, უნდა არსებობდეს შორის სივრცე
დახურვის PAREN და გაუწიოს, მოსწონს ეს.
თუმცა, CS50 ურჩევს braces დავდგეთ
საკუთარი ხაზი.
მოდით გავაკეთოთ, რომ.
არის, რომ ჩვენ სხეულში მთავარი ფუნქცია, ჩვენ გვჭირდება
დაიწყოს indenting კოდი; ჩვენ გამოიყენოს
რეკომენდებული ოთხი სივრცეებს.
შემდეგი, ჩვენ ვხედავთ, რომ იქ არ არის სივრცის გარშემო თანაბარი ნიშანი
აქ, მოდით დაამატოთ, რომ.
აქ ჩვენ ვხედავთ, რომ არ არსებობს სივრცის შორის, თუ და
ღია PAREN, მოდით დაამატოთ, რომ ერთად რამდენიმე სივრცის გარშემო
დიდი ვიდრე ნიშანი.
ერთხელ, ჩვენ ვხედავთ არ შორის სივრცე დახურვის PAREN და
გახსნის გაუწიოს აქ.
თუ ჩვენ ვაპირებთ, რომ ეს იმავე ხაზი, იქ სჭირდება
იყოს სივრცის წინაშე Curly გაუწიოს.
თუმცა, როგორც ჩანს სხეულის ჩვენი
მდგომარეობა არის მხოლოდ ერთი ხაზი.
ამიტომ ჩვენ არ უნდა შეიცავდეს braces ყველა.
ჩვენ ახლა უნდა დარწმუნებული აბზაცის დროს სხეულის თითოეული
ჩვენს პირობებში.
ჩვენ ნამდვილად არ მინდა ამ ბოლო ხაზის იყოს იმავე
ხაზის სხვას, მოდით დააჭიროთ და აბზაცის.
საბოლოოდ, დახურვის Curly გაუწიოს ძირითადი უნდა იყოს
საკუთარი ხაზი.
>> ჩვენ აქ გვაქვს ორი სხვადასხვა
ბლოკები დაკავშირებული კოდი.
ხაზები 4 მეშვეობით 6 შეეკითხება მომხმარებელს ამისთვის შეყვანის და
დარჩენილი ხაზების არიან, რომ შეყვანის რომ მომხმარებელს.
ასე რომ აზრი დააყენოს გარკვეული სივრცის შორის ამ ორი ბლოკის
ამისთვის სიწმინდე.
და იქ წასვლა, ახლა ეს კოდი არის ბევრად უფრო იოლია ახლა ერთად
კარგი სტილი.
>> საბოლოოდ, მოდით ვისაუბროთ ჩვენი მესამე კომპონენტის კარგი სტილი:
ცვლადი სახელები.
შენი variable სახელები უნდა აღწერს
ღირებულება, რომ ისინი წარმოადგენენ.
მოდით დავუბრუნდეთ ჩვენი ადრე მაგალითად.
ბოთლები არის კარგი აღწერითი სახელი ცვლადს,
წარმოადგენს რამდენი ბოთლი დარჩა კედელზე.
სახელები, როგორიცაა x ან numBots არ არის ძალიან აღწერითი და არიან
არ კარგი readability თქვენი კოდი.
მიუხედავად იმისა, ცვლადები მიერ დასახელებული ერთი წერილი არიან საერთო
მათემატიკის და სხვა სფეროებში, მათ შეუძლიათ თქვენი კოდი ძალიან რთულია
გასაგებია.
გარდა ამ წესის iterator
ცვლადები შიგნით მარყუჟების.
In for მარყუჟების, მაგალითად, ეს ჯარიმა გამოიყენოს variable
სახელები, როგორიცაა i, j, და k ამისთვის iteration.
როდესაც შექმნა iterator ცვლადები ფარგლებში მარყუჟების, ეს
რეკომენდებულია, რომ ამისათვის ფარგლებში loop თავად, არამედ
ვიდრე გარეთ მარყუჟის, ასე, რომ ჩვენ შეგვიძლია შევინარჩუნოთ ცვლადები როგორც
მჭიდროდ scoped შეიძლება.
>> მეორეს მხრივ, ცვლადის სახელი მოსწონს ბოთლების რაოდენობას
დაუტოვებიათ კედელზე არის, ხოლო აღწერითი, ზედმეტად verbose
და საჭირო არ არის.
იმ შემთხვევაში თუ თქვენ ჩვენგან გვინდა შეიქმნება ცვლადი ერთად
მრავალჯერადი სიტყვა, ცალკე იმ სიტყვებს ხაზს.
მაგალითად, is_ready გაცილებით იკითხება, ვიდრე isReady.
ეს ჯარიმა განაცხადოს მრავალჯერადი ცვლადები იმავე ხაზის.
თუმცა, თუ თქვენ ამისათვის არ ვრთავ ზოგიერთი ცვლადის მაგრამ
არ სხვები.
ეს იმას ნიშნავს, რაღაც int dimes, pennies
მძიმით, არის OK.
მაგრამ int dimes = 0, pennies
მძიმით არ არის.
>> და ბოლოს, როცა გამოცხადების პოინტერები, ის რეკომენდირებულია
რომ თქვენ მიიტანეთ ვარსკვლავი შემდეგ კურსორის ტიპი, არ
სახელწოდება ცვლადი.
ასე int * p რეკომენდირებულია ვიდრე int
სივრცეში * P.
Whoo!
ასე რომ, როგორც ჩანს, როგორიც ბევრი წესების
გვახსოვს, მაგრამ არ ინერვიულოთ.
თუ ოდესმე ეჭვი, ნუ დააყოვნებთ მიმართოს CS50-ს
ონლაინ სტილის სახელმძღვანელო.
>> მოდით სწრაფად შეჯამება მნიშვნელოვანი
წერტილები კოდი სტილი.
პირველი, კომენტარი თქვენი კოდი.
ყოველთვის, ყოველთვის, ყოველთვის აღწერს რა ფუნქციები გავაკეთოთ
ერთად მრავალ ხაზის კომენტარის და კომენტარის ყოველ რამდენიმე ხაზები
კოდი ხაზი.
მეორე.
შეესაბამება თქვენი კოდი გაფორმებით.
ყურადღება მიაქციეთ თქვენი განთავსებისა და გამოყენების braces
ასევე ინტერვალი გარშემო სიტყვა და ოპერატორები.
საბოლოოდ, აირჩიოს აღწერითი ცვლადი სახელები.
ცვლადები უნდა აღწერს ღირებულების ისინი წარმოადგენენ, მაგრამ
არ უნდა მოხდეს, თქვენ სამუდამოდ უნდა აკრიფოთ.
>> და ამით ყველაფერი.
ეს ყველაფერი სწრაფად გახდეს მეორე ბუნება, როგორც თქვენ
წერენ უფრო და უფრო კოდი და თქვენ უნდა კოდირების
სტილების დრო არ.
ჩემი სახელი არის ტომი, და ეს არის CS50.