Swift เทียบเท่ากับ - [คำอธิบาย NSObject] คืออะไร


163

ใน Objective-C เราสามารถเพิ่มdescriptionวิธีลงในคลาสเพื่อช่วยในการดีบัก:

@implementation MyClass
- (NSString *)description
{
    return [NSString stringWithFormat:@"<%@: %p, foo = %@>", [self class], foo _foo];
}
@end

จากนั้นในดีบักเกอร์คุณสามารถทำได้:

po fooClass
<MyClass: 0x12938004, foo = "bar">

อะไรที่เทียบเท่าใน Swift เอาต์พุต REPL ของ Swift มีประโยชน์:

  1> class MyClass { let foo = 42 }
  2> 
  3> let x = MyClass()
x: MyClass = {
  foo = 42
}

แต่ฉันต้องการลบล้างพฤติกรรมนี้สำหรับการพิมพ์ไปยังคอนโซล:

  4> println("x = \(x)")
x = C11lldb_expr_07MyClass (has 1 child)

มีวิธีล้างข้อมูลนี้printlnหรือไม่? ฉันเห็นPrintableโปรโตคอล:

/// This protocol should be adopted by types that wish to customize their
/// textual representation.  This textual representation is used when objects
/// are written to an `OutputStream`.
protocol Printable {
    var description: String { get }
}

ฉันคิดว่าสิ่งนี้จะ "เห็น" โดยอัตโนมัติprintlnแต่ดูเหมือนจะไม่เป็นเช่นนั้น:

  1> class MyClass: Printable {
  2.     let foo = 42
  3.     var description: String { get { return "MyClass, foo = \(foo)" } }
  4. }   
  5> 
  6> let x = MyClass()
x: MyClass = {
  foo = 42
}
  7> println("x = \(x)")
x = C11lldb_expr_07MyClass (has 1 child)

และฉันต้องเรียกคำอธิบายแทน:

 8> println("x = \(x.description)")
x = MyClass, foo = 42

มีวิธีที่ดีกว่า?

คำตอบ:


124

ในการดำเนินการนี้ในประเภทสวิฟท์คุณต้องใช้โปรโตคอลและจากนั้นยังใช้คุณสมบัติสตริงที่เรียกว่าCustomStringConvertibledescription

ตัวอย่างเช่น:

class MyClass: CustomStringConvertible {
    let foo = 42

    var description: String {
        return "<\(type(of: self)): foo = \(foo)>"
    }
}

print(MyClass()) // prints: <MyClass: foo = 42>

หมายเหตุ: type(of: self)รับชนิดของอินสแตนซ์ปัจจุบันแทนการเขียน 'MyClass' อย่างชัดเจน


3
เยี่ยมมาก! ฉันจะส่งเรดาห์ - println ของ "swift -i sample.swift" และ "swift sample.swift && sample" แตกต่างกัน
Jason

ขอบคุณสำหรับข้อมูลที่ ฉันกำลังลองพิมพ์ในสนามเด็กเล่นและแน่นอนมันไม่ทำงานในขณะนี้ ดีมากได้ยินว่าใช้งานได้ในแอพ
Tod Cunningham

พิมพ์ได้ทำงานในสนามเด็กเล่น แต่ถ้าชั้นเรียนลงมาจาก NSObject
dar512

5
ใน Swift 2.0 มันได้เปลี่ยนเป็น CustomStringConvertible และ CustomDebugStringConvertible
Mike Vosseller

นอกจากนี้ยังไม่มีปัญหาในการใช้ CustomStringConvertible และ CustomDebugStringConvertible ในสนามเด็กเล่นด้วย Xcode 7.2
Nicholas Credli

54

ตัวอย่างการใช้CustomStringConvertibleและCustomDebugStringConvertibleโปรโตคอลใน Swift:

PageContentViewController.swift

import UIKit

class PageContentViewController: UIViewController {

    var pageIndex : Int = 0

    override var description : String { 
        return "**** PageContentViewController\npageIndex equals \(pageIndex) ****\n" 
    }

    override var debugDescription : String { 
        return "---- PageContentViewController\npageIndex equals \(pageIndex) ----\n" 
    }

            ...
}

ViewController.swift

import UIKit

class ViewController: UIViewController
{

    /*
        Called after the controller's view is loaded into memory.
    */
    override func viewDidLoad() {
        super.viewDidLoad()

        let myPageContentViewController = self.storyboard!.instantiateViewControllerWithIdentifier("A") as! PageContentViewController
        print(myPageContentViewController)       
        print(myPageContentViewController.description)
        print(myPageContentViewController.debugDescription)
    }

          ...
}

สิ่งที่พิมพ์ออกมา:

**** PageContentViewController
pageIndex equals 0 ****

**** PageContentViewController
pageIndex equals 0 ****

---- PageContentViewController
pageIndex equals 0 ----

หมายเหตุ:ถ้าคุณมีคลาสที่กำหนดเองซึ่งไม่ได้รับการสืบทอดจากคลาสใด ๆ ที่รวมอยู่ในไลบรารีUIKitหรือมูลนิธิให้ทำการสืบทอดNSObjectคลาสหรือทำให้เป็นไปตามCustomStringConvertibleและCustomDebugStringConvertibleโปรโตคอล


ฟังก์ชั่นจะต้องประกาศให้เป็นสาธารณะ
Karsten

35

เพียงแค่ใช้CustomStringConvertibleและvar description: String { return "Some string" }

ทำงานใน Xcode 7.0 เบต้า

class MyClass: CustomStringConvertible {
  var string: String?


  var description: String {
     //return "MyClass \(string)"
     return "\(self.dynamicType)"
  }
}

var myClass = MyClass()  // this line outputs MyClass nil

// and of course 
print("\(myClass)")

// Use this newer versions of Xcode
var description: String {
    //return "MyClass \(string)"
    return "\(type(of: self))"
}

20

คำตอบที่เกี่ยวข้องCustomStringConvertibleเป็นวิธีที่จะไป โดยส่วนตัวเพื่อให้คำจำกัดความของคลาส (หรือ struct) นั้นสะอาดที่สุดเท่าที่จะทำได้ฉันจะแยกรหัสคำอธิบายออกเป็นส่วนขยายแยกต่างหาก:

class foo {
    // Just the basic foo class stuff.
    var bar = "Humbug!"
}

extension foo: CustomStringConvertible {
    var description: String {
        return bar
    }
}

let xmas = foo()
print(xmas)  // Prints "Humbug!"

8
class SomeBaseClass: CustomStringConvertible {

    //private var string: String = "SomeBaseClass"

    var description: String {
        return "\(self.dynamicType)"
    }

    // Use this in newer versions of Xcode
    var description: String {
        return "\(type(of: self))"
    }

}

class SomeSubClass: SomeBaseClass {
    // If needed one can override description here

}


var mySomeBaseClass = SomeBaseClass()
// Outputs SomeBaseClass
var mySomeSubClass = SomeSubClass()
// Outputs SomeSubClass
var myOtherBaseClass = SomeSubClass()
// Outputs SomeSubClass

6

ตามที่อธิบายไว้ที่นี่คุณยังสามารถใช้ความสามารถในการสะท้อนของ Swift เพื่อทำให้คลาสของคุณสร้างคำอธิบายของตนเองโดยใช้ส่วนขยายนี้:

extension CustomStringConvertible {
    var description : String {
        var description: String = "\(type(of: self)){ "
        let selfMirror = Mirror(reflecting: self)
        for child in selfMirror.children {
            if let propertyName = child.label {
                description += "\(propertyName): \(child.value), "
            }
        }
        description = String(description.dropLast(2))
        description += " }"
        return description
    }
}

4
struct WorldPeace: CustomStringConvertible {
    let yearStart: Int
    let yearStop: Int

    var description: String {
        return "\(yearStart)-\(yearStop)"
    }
}

let wp = WorldPeace(yearStart: 2020, yearStop: 2040)
print("world peace: \(wp)")

// outputs:
// world peace: 2020-2040
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.