UITableViewCell内に配置したTextFieldの値を取得したい

Question

前提・実現したいこと

textFieldを配置したカスタムセルを作成しました。
カスタムセルと同画面のボタンを押下時に、各カスタムセルのtextFieldに
入力されたそれぞれの値を取得したいのですが、調べても実装方法が分からず
手詰まってしまったので、ご教示頂きたいです。

具体的には、以下画面の＋ボタンを押下時に
各セルの1000,2000,3000の値を取得したいです。

宜しくお願い致します。

該当のソースコード

class InputCostsViewController: UIViewController {
    
    var items:[UtilityCosts] = [
        UtilityCosts.Electricity,
        UtilityCosts.Gas,
        UtilityCosts.Water
    ]
    
    var result:[UtilityCosts:String] = [:]
    
    @IBOutlet weak var inputCostsTableView: UITableView!{
        didSet{
            let nib = UINib(nibName: InputCostsTableViewCell.identifire, bundle: nil)
            inputCostsTableView.register(nib, forCellReuseIdentifier: InputCostsTableViewCell.identifire)
            
            inputCostsTableView.dataSource = self
            
            inputCostsTableView.allowsSelection = false
            inputCostsTableView.tableFooterView = UIView(frame: .zero)
        }
    }
    
    @IBAction func RegisterCosts(_ sender: UIButton) {
        print(result)
        
        //navigationController?.popViewController(animated: true)
    }
    
    override func viewDidLoad() {
        super.viewDidLoad()
    }
}

extension InputCostsViewController:UITableViewDataSource{
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return items.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: InputCostsTableViewCell.identifire, for: indexPath) as! InputCostsTableViewCell
        cell.configure(kind: items[indexPath.row])
        cell.delegate = self
        
        return cell
    }
    
    func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
        return 50
    }
}

extension InputCostsViewController:TextFieldEditCellDelegate{
    func textFieldEditingChanged(cell: InputCostsTableViewCell, value: String) {
        let key = cell.kind
        result.updateValue(value, forKey: key)
    }
}

protocol TextFieldEditCellDelegate:class {
    func textFieldEditingChanged(cell:InputCostsTableViewCell,value:String)
}

class InputCostsTableViewCell: UITableViewCell {
    
    @IBOutlet weak var icon: UIImageView!
    @IBOutlet weak var textField: UITextField!{
        didSet{
            textField.borderStyle = .none
            textField.keyboardType = .numberPad
        }
    }
    
    var kind = UtilityCosts.None
    weak var delegate:TextFieldEditCellDelegate? = nil
    static let identifire = "InputCostsTableViewCell"
    
    override func awakeFromNib() {
        super.awakeFromNib()
        textField.addTarget(self, action: #selector(editingChanged), for: .editingChanged)
    }

    override func setSelected(_ selected: Bool, animated: Bool) {
        super.setSelected(selected, animated: animated)
    }
    
    func configure(kind:UtilityCosts){
        self.kind = kind
        self.icon.image = kind.icon
        self.textField.placeholder = kind.name
    }
    
    @objc func editingChanged(textField: UITextField) {
        self.delegate?.textFieldEditingChanged(cell: self, value: textField.text!)
    }
}

enum UtilityCosts{
    case None
    case Electricity
    case Gas
    case Water
    
    var name:String{
        switch self {
        case .None:
            return ""
        case .Electricity:
            return "電気代"
        case . Gas:
            return "ガス代"
        case .Water:
            return "水道代"
        }
    }
    
    var icon:UIImage?{
        switch self {
        case .None:
            return nil
        case .Electricity:
            return nil
        case . Gas:
            return nil
        case .Water:
            return nil
        }
    }
}

試したこと

調べたことを記載します。

textFieldが入力されたタイミングでセルが1つであれば
こちらの方法で実装することはできましたが、セルが複数になった時の各値を
取得するところの解答にまでは辿り着けませんでした。

Answer 1

UITableViewの特性として、

• Cellは再利用される可能性がある≒スクロールして画面外に行くとセルにアクセスできなくなる可能性がある

という点に注意してください。
つまり全Cellがメモリ上に存在するとは限らないということです。

テキストフィールドの文字列と行番号(row)が取れているのでしたら、その値をメンバ変数として配列等に格納すれば良いと思います。
（こうすればCellが画面外に行って再利用されたとしても、入力した値をとっておくことができます。）

すべての値が必要になった場合はその配列の値を参照すればOKです。
また、セルの構築の際（func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)）、その配列に入っている値をUITextFiled.textに再度格納するという手順も必要です。

Comments

[pftyuk]

ご回答頂きありがとうございます。

UITableViewの特性については理解しました。
飲み込みが悪く、いまいちピンときてないのでご教示下さい。

テキストフィールドの文字列と行番号(row)が取れているのでしたら、その値をメンバ変数として配列等に格納すれば良いと思います。
→こちらについては、どのタイミングで保存用の配列等に格納すれば宜しいのでしょうか・・・。
　追記で書かせて頂いたのでご覧頂けると幸いですが、生成したセルのインスタンス自体を
　保持するのとは違いますよね・・・？

また、セルの構築の際（func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)）、その配列に入っている値をUITextFiled.textに再度格納するという手順も必要です。
→こちらは"再度格納するという手順も必要"理由が全くわからなかったので
　もう少し詳しくお聞かせ願いたいです。

恐縮ですが、宜しくお願いします。

[takabosoft]

格納するタイミングは参考にしたサイトと同じ「UITextFieldDelegate.textFieldDidEndEditing」か、一文字でも変わったら即座に格納（addTarget＆.editingChanged）でもどちらもでたぶん大丈夫ですので検証してみてください。
保持するのはセルやUITextFieldのインスタンスではなく、UITextField.text、つまり文字列（もしくはそれを変換した数値）だけです。

> こちらは"再度格納するという手順も必要"理由が全くわからなかった

極端な話ですが、例えば理論上のCellの数が1000個で画面に収まるセルが10個しかないと仮定します。
（※UITableViewはこの時画面に表示される最低限のCell（つまり10個）しかセルを要求しません。）
あるCellのインスタンスAはItem0番目の表示のために構築されたとします。
ここでユーザーがCellのインスタンスAのテキストフィールドに1000を入力し、その値（1000）をメンバ変数に保持できたとします。

さて、回答欄でも説明したとおり、UITableViewのCellのインスタンスはメモリ節約のためにリサイクルされるという特性があります。

実際とは異なりますが、例えばテーブルを少し上にスクロールすると、
Item0番目として用意したCellのインスタンスAは画面外に出ます。
すると、UITableViewは、このCellのインスタンスAを不要なものとしてテーブルビューから外し、プールします（適当な場所に置いておきます）。

次にスクロール後出てくるItem10番目のためにUITableViewはユーザーへcellの提供をdelegate経由で指示します。

このときfunc tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)関数内で

> tableView.dequeueReusableCell(withIdentifier: "InputCostsTableViewCell", for: indexPath)

というAPIを呼んでセルのインスタンスを構築していると思いますが、この関数名には
よく見ると「Reusable」という単語が含まれているのがわかると思います。

つまり再利用できるセルがあるならそれをデキュー（≒プールしてあるセルがあるならもってこい）、無いなら新規にインスタンスを作成せよ、というAPIになります。

この例え話ではさきほどItem0用に作成したCellのインスタンスAがプールされていますので、
Item10番用にcellをdequeueするとCellのインスタンスAがもらえます。

するとどうでしょう、cellのインスタンスAのUITextFiledには前に入力した1000という文字列が残っていますから、Item10番目が本来表示するべき値とは異なってしまうことになります。

そのため、UITextFiled.textに再度適切な値を格納（新しいItemであれば空だし、過去に入力済みの値であればその値を再度格納）しないと、再利用したときに前の値が出てしまい、おかしなことになるというわけです（再利用でなく、新規作成されたCellのインスタンスに対しても同様に再格納は必要ですが）。

---
長々と書きましたが、今回のように3つしかItemが無いと決まっているのでしたら、セルのリサイクルについて意識する必要は実はありませんし、「リサイクルの機構をあえて使わない」という手もあります。ただUITableViewとの付き合いはおそらく長くなると思うので、仕組みをしっかりと理解しておいてほしいと思います。あとこのCellリサイクルの仕組みはUICollectionViewにもあります。

[pftyuk]

ご回答頂きありがとうございます。
返信が遅くなり大変恐縮です。

UITableViewのセルの再利用について
非常に細かくご説明頂き、本当にありがとうございます。
具体的な例を挙げてご説明頂き、頭が上がりません。。。
正直UITableViewについては知識としてかなり怪しい部分が多いので
少しずつ仕組みについてきちんと理解を深めていきたいと思います。

格納については実装ができたので、質問欄のコードを
解決済みのものに修正させて頂きました。
UITextFieldDelegate.textFieldDidEndEditingで実装してみたところ
カーソルが離れたタイミングでの呼び出しになり都合が悪かっため
ご教示頂いたaddTarget＆.editingChangedで試してみました。
正直、addTarget辺りの書き方がきちんと飲み込めてないので調べて理解を深めておきます。
書き方等、怪しい所があればご指摘頂けると幸いです。

質問事項については解決しましたので
ベストアンサーとし閉じさせて頂きました。この度は誠にありがとうございました。

[takabosoft]

addTarget＆.editingChangedは動いていればそれで問題ありません。おそらくストーリーボードからでもeditingChangedの@IBActionをドラッグ＆ドロップ作れますので、そちらからのほうが楽かもしれません（コードからでもなんら問題はありません）。

本題とは逸れますが、enumの各要素の頭文字は小文字が一応公式な書き方です。
https://docs.swift.org/swift-book/LanguageGuide/Enumerations.html
（Swift初期のバージョンでは頭文字は大文字でしたが、途中のバージョンから小文字が正式になりました）

[pftyuk]

ストーリーボード から作れるのは知りませんでした。

enumの各要素は今は小文字が公式的な書き方なのですね。
こちらも知らなかったので修正してみます。ご丁寧にありがとうございました！