連絡先に保存されている名前やメールアドレスをString型で取り出してセルに表示したい

Question

iPhoneの連絡先アプリに保存されている名前やメールアドレスをString型で取り出して、cellに表示したいのですが上手くできません。

iPhoneの連絡先アプリに保存されている名前やメールアドレスをString型で取り出して、cellに表示しようとしています。そのためには連絡先にアクセスする必要があり、Contacts.frameworkを追加しなければならないことはわかりましたが、そこからどんなクラスやプロパティを使えば名前やメールアドレスをString型で取り出せるのかが分かりません。

発生している問題・エラーメッセージ

連絡先のデータをString型で取り出す為のクラスやプロパティが分からない

該当のソースコード

import UIKit
import Contacts

class ViewController2: UIViewController, UITableViewDelegate, UITableViewDataSource {
    
    var name = [String]()
    
    //cellの数は連絡先から取り込んだ人の数
    @IBOutlet weak var TableView: UITableView!
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return name.count
    }
    
    //cellに表示するのは取り込んだ人の名前
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
        cell.textLabel?.text = name[indexPath.row]
        return cell
    }

//以下に電話帳から名前やメールアドレスをString型で取り出してnameに代入したいが分からない

試したこと

webに記載されていたあまり意味のわかっていない以下のソースコードを使用してみましたが、保存されている型がCNContactである為name = peopleのようには代入できませんでした。

func getContacts() {
// 連絡先を取得するクラスのインスタンスを作成
let store = CNContactStore.init()
// 連絡帳の1つ1つのデータを収める空の配列 people を準備
var people = CNContact

    do {
        // 連絡先データベースからここでは苗字・名前・電話番号情報を取得
        try store.enumerateContacts(with: CNContactFetchRequest(keysToFetch: [CNContactGivenNameKey as CNKeyDescriptor, CNContactFamilyNameKey as CNKeyDescriptor, CNContactEmailAddressesKey as CNKeyDescriptor])) {(contact, cursor) -> Void in// 電話番号が保持されている連絡先だったら
            if (!contact.phoneNumbers.isEmpty) {// 取得したデータをpeople に収める
                                                people.append(contact)
            }
        }
    }
    catch{
        print("連絡先データの取得に失敗しました")
    }
    
    // peopleに取得した連絡先の数だけループ
    for humen in people{
        
        // 連絡先が保持している電話番号の数だけループ
        for number in humen.phoneNumbers {
            
            // 「電話：電話番号　名前：苗字 ま前」のフォーマットで連絡先データが出力される
            print("電話：((number.value as CNPhoneNumber).stringValue) 名前：(humen.familyName) (humen.givenName)")
        }
    }
   
}

補足情報（FW/ツールのバージョンなど）

ここにより詳細な情報を記載してください。

Answer 1

上記のコードで、var people = [CNContact]()と宣言されているので、peopleの型は[CNContact]です。（CNContactとは異なります。）

この場合に、peopleの最初の連絡先の名字を取得するなら、以下のようにして取得できます。

let human: CNContact = people[0]
let familyName: String = human.familyName  //名字
let givenName: String = human.givenName    //名前
print("名前: (familyName) (givenName)")  //"名前: 田中 太郎"

メールアドレスは、以下のようにして取得できます。

let emailAddresses: [CNLabeledValue<NSString>] = human.emailAddresses
for emailAddress in emailAddresses {
  if let emailText = emailAddress.value as String {
    print("メール: (emailText)")  //"メール: [e-mail]"
  }
}

CNContactから取得できる項目は、Apple Developer Documentation - CNContact （英語）で確認できます。

---

Xcodeでは、Optionキーを押しながらコード上のクラスをクリックすると、そのクラスの簡易説明を見ることができます。詳細が分からないクラスがあった場合、この機能が活用できるかもしれません。

Comments

[clocker]

丁寧な解説ありがとうございます。名前の方はString型で上手く取り出すことに成功しました。しかしメールアドレスの方は回答のコードをコピーアンドペースとしたところ「if let emailText = emailAddress.value as? String {」の行で「Conditional cast from 'NSString' to 'String' always succeeds」というような表示が出てきて上手くいきませんでした。これはどういう意味でどうすれば良いのでしょうか。またfor分のemailAddress in emailAddressesとif let emailText = emailAddress.value as? Stringの意味を教えて頂けないでしょうか。よろしくお願いします。

[退会済みユーザー]

「Conditional cast from 'NSString' to 'String' always succeeds」についてですが、意味は書いてある通りで、不要なキャストに対する警告表示です。（コードを書き間違えましたので、修正しておきます。）for文とif文については、swiftの基本的な項目です。ここで説明すると、この質問の質問内容を超える回答となるので、ここでの回答は控えます。必要であれば、別の質問としてあげていただければと思います。

[clocker]

回答本当にありがとうございます。おかげで連絡先に保存されている名前やメールアドレスをString型で取り出してセルに表示することが出来ました。