Self-Documenting のススメ

Transcript

1. 4FMG%PDVNFOUJOH
   $PEF
 ͷεεϝ for
   J04%$
   
   3FKFDU
   $POGFSFODF
   EBZT

2. r੕໺ܙྤ lզʑΤϯδχΞ͸େͬݏ͍ͳ͜ͱ͕
   C
   ͭ͋Δ
    C
   ͭ໨͸υΩϡϝϯτΛॻ͘͜ͱɻ
    C
   ͭ໨͸υΩϡϝϯτͷͳ͍ଞਓ͕ॻ͍ͨ
 ίʔυΛอक͢Δ͜ͱͩɻz

3. r੕໺ܙྤ lզʑΤϯδχΞ͸େͬݏ͍ͳ͜ͱ͕
   C
   ͭ͋Δ
    C
   ͭ໨͸υΩϡϝϯτΛॻ͘͜ͱɻ
    C
   ͭ໨͸υΩϡϝϯτͷͳ͍ଞਓ͕ॻ͍ͨ
 ίʔυΛอक͢Δ͜ͱͩɻz

4. r੕໺ܙྤ lզʑΤϯδχΞ͸େͬݏ͍ͳ͜ͱ͕
   C
   ͭ͋Δ
    C
   ͭ໨͸υΩϡϝϯτΛॻ͘͜ͱɻ
    C
   ͭ໨͸υΩϡϝϯτͷͳ͍ଞਓ͕ॻ͍ͨ
 ίʔυΛอक͢Δ͜ͱͩɻz ʊਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓਓʊ
   ʼɹͩͬͨΒ࠷ॳ͔ΒυΩϡϝϯτͱͯ͠΋ɹʻ
   ʼɹ࢖͑ΔίʔυΛॻ͚͹ສࣄղܾͳͷͰ͸

   ɹʻ
   ʉ:?:?:?:?:?:?:?:?::?:?:?:?:?:?:?:?:ʉ

5. } var employedBy = "YUMEMI Inc." var job = "iOS

   Developer" var favoriteLanguage = "Swift" var twitter = "@lovee" var qiita = "lovee" var github = "el-hoshino" var additionalInfo = """ iOSDC 2018 CfP શ෦མͪͨਏ͍ """ class Me: Developable, Talkable {

6. ໔੹આ໌ w "͜ͷτʔΫ͸ίʔσΟϯάνοϓεతͳ࿩Ͱ͋Δ
   w #͜ͷτʔΫ͸υΩϡϝϯτࣗಈੜ੒ͷ࿩Ͱ͸ͳ͍

7. rӳࣙ࿠ l4FMGEPDVNFOUJOH
   DPEFɿࣗݾจॻԽίʔυz

8. let s = (0 ..< 50) .map({ _ in Int.random(in:

   0 ... 100) }) .filter({ $0 >= 60 }) .reduce(0, +)

9. let s = (0 ..< 50) .map({ _ in Int.random(in:

   0 ... 100) }) .filter({ $0 >= 60 }) .reduce(0, +)

10. private extension Int { var isPassed: Bool { return self

    >= 60 } } let numberOfStudents = 50 let studentsScoreList = (0 ..< numberOfStudents) .map({ _ -> Int in let score = Int.random(in: 0 ... 100) return score }) let passedStudentsScoreList = studentsScoreList .filter({ $0.isPassed }) let totalScoreOfAllPassedStudents = passedStudentsScoreList .reduce(0, +) ͳΔ΄Ͳɺςετʹ߹֨ͨ͠ੜెͷ
 ఺਺ͷ߹ܭͶʂ

11. r੕໺ܙྤ l4FMGEPDVNFOUJOH
    DPEFɿࣗ෼ࣗ਎ͷҙຯΛ
 ͖ͪΜͱઆ໌Ͱ͖͍ͯΔίʔυz

12. ͳͥ
    4FMG%PDVNFOUJOH
    $PEFʁ w ಉ͜͡ͱΛʮίʔυʯͱʮυΩϡϝϯτʯ྆ํͰॻ͘ ͱ͍͏ೋ౓ख͕ؒݮΔɻ
    w w w w w w

    w w ίʔυϨϏϡʔ͕ΑΓ͠΍͘͢ͳΔɻ
    w ίϛολʔͷҙਤ͕ಡΈऔΓ΍͘͢ͳΔ
    w w w w w w w w w w w อक͢Δ࣌ʹ໰୊ՕॴΛಛఆ͠΍͘͢ͳΔ w w w w w w

13. 4FMG%PDVNFOUJOH
    $PEF
    ΁ͷΞϓϩʔν w ՄಡੑʹؾΛ͚ͭΔ
    w ໰୊Λࡉ͔͘ந৅Խ
    w ҉໧ͳલఏΛͳ͘͢

14. ՄಡੑʹؾΛ͚ͭΔ

15. ՄಡੑʹؾΛ͚ͭΔʢʣ ͳΜͷ
    63-
    ͩΖʁ let url = URL(string: "https://iosdc.jp/2018/")!

16. ՄಡੑʹؾΛ͚ͭΔʢʣ let apiBaseURL = URL(string: "https://iosdc.jp/2018/")! "1*
    ͷ ϕʔε
    63-
    ͩͶʂ

17. r୭͔ l؆ܿ͞ΑΓɺΘ͔Γ΍͢͞z

18. ՄಡੑʹؾΛ͚ͭΔʢʣ class Player { // ... var allowsMagic: Bool {

    return // ຐ๏͕࢖͑Δ͔Ͳ͏͔ͷ൑ఆ } } ຐ๏Λ ڐՄʜʁ

19. ՄಡੑʹؾΛ͚ͭΔʢʣ class Player { // ... var canUseMagic: Bool {

    return // ຐ๏͕࢖͑Δ͔Ͳ͏͔ͷ൑ఆ } } ຐ๏͕ ࢖͑Δ͔Ͳ͏͔͔ʂ

20. r୭͔ lޡղͷͳ͍දݱʹؾΛ͚ͭΑ͏z

21. ՄಡੑʹؾΛ͚ͭΔʢʣ func addSubview(_ subview: UIView, _ baseView: UIView) { baseView.addSubview(subview)

    } addSubview(avatarView, contentView) Ͳ͕ͬͪͲͬͪʹ ௥Ճ͞ΕΔͷʜʁ

22. ՄಡੑʹؾΛ͚ͭΔʢʣ func addSubview(subview: UIView, baseView: UIView) { baseView.addSubview(subview) } addSubview(subview:

    avatarView, baseView: contentView) ଟ෼
    avatarView
    ͕ࢠϏϡʔͰ
    contentView
    ͕਌Ϗϡʔʁ

23. ՄಡੑʹؾΛ͚ͭΔʢʣ avatarView
    Λ
    contentView
    ͷ্ʹ௥ՃͩͶʂ func addSubview(_ subview: UIView, onto baseView: UIView)

    { baseView.addSubview(subview) } addSubview(avatarView, onto: contentView)

24. r୭͔ lҾ਺ϥϕϧΛ͏·͘׆༻͠Α͏z

25. ՄಡੑʹؾΛ͚ͭΔʢʣ func addSubview(_ subview: UIView, onto baseView: UIView) { baseView.addSubview(subview)

    } addSubview(avatarView, onto: contentView)

26. ՄಡੑʹؾΛ͚ͭΔʢʣ func addSubview(_ subview: UIView, onto baseView: UIView, ifNeeded) {

    if !baseView.subviews.contains(where: { $0 === subview }) { baseView.addSubview(subview) } } addSubview(avatarView, onto: contentView, ifNeeded) ಡΈ΍͍͕͢
 จ๏ΤϥʔͰ͋Δ

27. r੕໺ܙྤ l4XJGU
    ͷจ๏ʹ།Ұʹͯ͠࠷େͷෆຬ఺͸
 ޙஔϥϕϧ͕ͳ͍͜ͱz

28. ՄಡੑʹؾΛ͚ͭΔʢʣ func addSubview(_ subview: UIView, onto baseView: UIView, ifNeeded) {

    if !baseView.subviews.contains(where: { $0 === subview }) { baseView.addSubview(subview) } } addSubview(avatarView, onto: contentView, ifNeeded)

29. ՄಡੑʹؾΛ͚ͭΔʢʣ enum AddSubviewPostLabel { case ifNeeded } func addSubview(_ subview:

    UIView, onto baseView: UIView, _ label: AddSubviewPostLabel) { if !baseView.subviews.contains(where: { $0 === subview }) { baseView.addSubview(subview) } } addSubview(avatarView, onto: contentView, .ifNeeded) ߈ུ"ɿޙஔϥϕϧ༻ͷ
    enum
    Ҿ਺Λ׶͑ͯ࡞Δ
    ɿར༻෦ΛಡΉͱ͔ͳΓಡΈ΍͍͢
    ɿenum
    ΛΘ͟Θ͟ఆٛ͠ͳ͍ͱ͍͚ͳ͍ɺ໘౗ष͍ɺ໊લিಥ͠΍͍͢

30. ՄಡੑʹؾΛ͚ͭΔʢʣ func addSubview(_ subview: UIView, onto baseView: UIView, ifNeeded: ())

    { if !baseView.subviews.contains(where: { $0 === subview }) { baseView.addSubview(subview) } } addSubview(avatarView, onto: contentView, ifNeeded: ()) ߈ུ#ɿޙஔϥϕϧ༻ͷμϛʔҾ਺Λ࡞Δ
    ɿԿ΋௥ՃͰఆٛ͢Δඞཁ͕ͳ͍ɺָ
    ɿར༻෦ΛಡΉ࣌ඍົʹͳͥ͜ͷҾ਺౉ͯ͠Δͷ͔Λߟ͑ͯ͠·͍ͦ͏

31. ՄಡੑʹؾΛ͚ͭΔʢʣ ߈ུ$ɿ࠷ॳ͔ΒޙஔϥϕϧΛ࡞Βͳ͍
    ɿճΓ͘Ͳ͍ϫʔΫΞϥ΢ϯυ͕ཁΒͳ͍
    ɿӳจ๏ͱͯͪ͠ΐͬͱඍົͳͷͰ΋͏ͪΐͬͱ໊લͷ޻෉͕ඞཁ͔΋ func addSubviewIfNeeded(_ subview: UIView, onto baseView:

    UIView) { if !baseView.subviews.contains(where: { $0 === subview }) { baseView.addSubview(subview) } } addSubviewIfNeeded(avatarView, onto: contentView)

32. r੕໺ܙྤ l݁࿦ɿޙஔϥϕϧཉ͍͠ɻz

33. ՄಡੑʹؾΛ͚ͭΔʢʣ class SomeSequence { private var numbers: [Int] = [3,

    2, 1] private var isSorted: Bool = false // ... func getSorted() -> [Int] { self.numbers = self.numbers.sorted(by: <) self.isSorted = true return self.numbers } } let sequence = SomeSequence() // Կ͔ॲཧ... let sorted = sequence.getSorted() ฒͼସ͑ΒΕͨ഑ྻΛऔΖ͏ͱͨ͠
 ͚ͩͳͷʹ
    sequence
    ͷঢ়ଶ͕มΘͬͨ

34. ՄಡੑʹؾΛ͚ͭΔʢʣ class SomeSequence { private var numbers: [Int] = [3,

    2, 1] private var isSorted: Bool = false // ... @discardableResult func sort() -> [Int] { self.numbers = self.numbers.sorted(by: <) self.isSorted = true return self.numbers } } let sequence = SomeSequence() // Կ͔ॲཧ... let sorted = sequence.sort() ͜ͷϝιου͸໭Γ஋͕͋Δ͕
 ෭࡞༻΋͋Δϝιουͩʂ

35. r୭͔ l෭࡞༻͕͋Δ͔Ͳ͏͔Λ໌ࣔ͠Α͏z

36. IUUQTTXJGUPSHEPDVNFOUBUJPOBQJEFTJHOHVJEFMJOFTTUSJWFGPSqVFOUVTBHF

37. ՄಡੑʹؾΛ͚ͭΔ w ؆ܿ͞ΑΓɺΘ͔Γ΍͢͞
    w ޡղͷͳ͍දݱʹؾΛ͚ͭΑ͏
    w Ҿ਺ϥϕϧΛ͏·͘׆༻͠Α͏
    w ෭࡞༻͕͋Δ͔Ͳ͏͔Λ໌ࣔ͠Α͏

38. クイズ：象さんを冷蔵庫に入れる手順は？ 1.冷蔵庫のドアを開ける 2.象さんを冷蔵庫の中に入れる 3.冷蔵庫のドアを閉める

39. ࡉ͔͘ந৅Խ

40. ࡉ͔͘ந৅Խ class SomeScreen { func presentWebPage() { // ΞυϨεόʔΛ... //

    ໭ΔϘλϯΛ... // ... // จࣈྻΛ URL ʹ... // URL ͔ΒϦΫΤετΛ... // ... // จࣈίʔυΛ... // ಺༰ͷϨΠΞ΢τΛ... // ... // } }

41. ࡉ͔͘ந৅Խ class SomeScreen { func presentWebPage() { // ॳظ WebPage

    ը໘Λ࡞Δ // ࡞ͬͨ WebPage ը໘ʹભҠ͢Δ // ભҠ͕ऴΘͬͨΒ WebPage ը໘ͰಡΈࠐΉ } }

42. ࡉ͔͘ந৅Խ class SomeScreen { func presentWebPage() { let screen =

    WebPageScreen() self.present(screen, completion: { screen.loadAddress("user_defined") }) } }

43. ࡉ͔͘ந৅Խ class SomeScreen { // presentWebPage private func present(_ screen:

    WebPageScreen, completion: () -> Void) { // ભҠॲཧʹઐ೦ } } class WebPageScreen { // ը໘ߏ੒ʹઐ೦ func loadAddress(_ address: String) { // ಡΈࠐΈॲཧʹઐ೦ } }

44. ໰୊Λࡉ͔͘ந৅Խ͢Δ w ͍͖ͳΓ۩ମతͳ࣮૷Λߟ͑ͳ͍
    w ෳࡶͳ໰୊͸ͦ΋ͦ΋ߟ͑Δͷ͸೉͍͠
    w ؆୯ͳ໰୊Ͱ΋͋Δఔ౓ͬ͘͟ΓͳΠϝʔδ͕͍͍
    w ෳࡶͳػೳ΄Ͳɺͪΐͬͱͣͭ෼ׂ͢Δ
    w

    Ұ౓ʹߟ͑Δ໰୊ΛߜΕΔ
    w 5%%
    ʹ΋௨͡Δߟ͑ํ
    w ςετ΋ॻ͖΍͘͢ͳΔͱ͍͏خ͍͠෭࡞༻
    w ෦඼ͷ੹຿ʹઐ೦͢Δ
    w ඞཁʹԠͯ͡
    %FMFHBUF
    ΍
    $MPTVSF
    ʹؙ౤͛

45. ҉໧ͳલఏΛͳ͘͢

46. ҉໧ͳલఏΛͳ͘͢ class SomeContainerView: UIScrollView { var childViews: [UIView] = []

    // ... func scrollToView(at index: Int) { self.contentOffset.x = self.bounds.width * CGFloat(index) } } த਎ಡΜͰΈͨΒ
 ͜Ε͸֤
    childView
    ͷ෯͕ࣗ਎ͷ෯ͱಉ͡
 ͱ͍͏લఏͰಈ͍ͯΔॲཧͩ

47. ҉໧ͳલఏΛͳ͘͢ class SomeContainerView: UIScrollView { var childViews: [UIView] = []

    // ... func scrollToView(at index: Int) { self.contentOffset = self.childViews[index].frame.origin } } ͍ͭͲ͜Ͱ୭ʹݺ͹ΕΑ͏ͱඞͣ ֘౰
    childView
    ͕දࣔ͞ΕΔॲཧͰ͋Δ 
 ʢchildView
    ͷϨΠΞ΢τͱ͍͏҉໧ͳલఏʹ ґଘ͠ͳ͍ʣ

48. ҉໧ͳલఏΛͳ͘͢ class SomeContainerView: UIScrollView { private var childViews: [UIView] =

    [] // ... func scrollToChildView(at index: Int) { let childView = self.childViews[index] assert(childView.superview === self) self.contentOffset = childView.frame.origin } } Ͳ͏ͯ͠΋֎ͤͳ͍લఏ͸ ඞͣ໌ࣔ͢Δ

49. ҉໧ͳલఏΛͳ͘͢ w ͍ͭͲ͜Ͱ୭ʹݺ͹Εͯ΋ಉ݁͡ՌʹͳΔΑ͏ʹ࡞Δ
    w Ͳ͏ͯ͠΋ඞཁͳલఏΛ໌ࣔ͢Δ
    w લఏΛҾ਺ʹͰ͖Ε͹Ҿ਺ʹ͢Δ
    w લఏΛҾ਺ʹͰ͖ͳ͚Ε͹໊લʹ૊ΈࠐΉ
    w

    ໊લʹ૊ΈࠐΉʹ΋೉͍͠৔߹͸࣮૷ͰΞαʔτ

50. 4FMG%PDVNFOUJOH
    $PEF
    ΁ͷΞϓϩʔν w ՄಡੑʹؾΛ͚ͭΔ
    w ໰୊Λࡉ͔͘ந৅Խ
    w ҉໧ͳલఏΛͳ͘͢

51. ͡Ό͋
    4FMG%PDVNFOUJOH
    $PEF
    Ͱॻ͍ͨϓϩάϥϜ͸
 ίϝϯτ΍υΩϡϝϯτ͕શ͘ཁΒͳ͘ͳΔͷʁ

52. 4FMG%PDVNFOUJOH
    $PEF
    ͚ͩͰ͸଍Γͳ͍ w $PEF
    ͸ʮ8IBUʯͱʮ)PXʯ͚͔ͩ͠આ໌Ͱ͖ͳ͍
    w ϓϩάϥϜ΍ϓϩδΣΫτΛཧղ͢ΔͨΊʹ͸ ʮ8IZʯ΋ඞཁʢΠϨΪϡϥʔͳ࢓༷આ໌ͳͲʣ
    w υΩϡϝϯτ΍ίϝϯτͰ
    8IBU
    ͱ
    )PX
    Λઆ໌͠ͳ ͯ͘ࡁΉ୅ΘΓʹɺ8IZ
    ͷઆ໌ʹઐ೦Ͱ͖Δ
    w

    ݁Ռͱͯ͠ඞཁՕॴ΍ϘϦϡʔϜ͕ݮΔʂ

53. 4FMG%PDVNFOUJOH
    $PEF
    Ͱ
 ফ໣ͷগͳ͍։ൃϥΠϑΛ