Summary  
This chapter explains how to use `**kwargs` to let a function accept any number of named arguments as a dictionary, and shows how to iterate over those key–value pairs for tasks such as printing or conditional filtering.  

General domain of usage  
Data processing

プログラミングにおいて、関数に任意の数の名前付きパラメータを渡すための特別な構文として、`**kwargs` があります。

`**kwargs` を使うことで、関数は任意の数の名前付き引数を受け取り、それらを辞書として扱うことができます。

def example_function(**kwargs):
    for key, value in kwargs.items():
        print(f'{key}: {value}')

# Example function call
example_function(name='John', age=25, city='New York')

この例では、`**kwargs` が名前付き引数を受け取り、そのキーと値を出力しています。



`.items()` メソッドは、Python の辞書からキーと値のペアのリストを取得するために使用されます。このリストの各要素は、タプル (key, value) として表されます。

注記

`**kwargs` を使って、条件に基づいてデータをフィルタリングすることも可能です。例えば、値が特定のしきい値を満たすエントリのみを保持する場合：


def filter_by_value(threshold, **kwargs):
    result = {}
    for key, value in kwargs.items():
        if value >= threshold:
            result[key] = value
    return result

print(filter_by_value(50, apple=30, banana=60, cherry=80))

ここでは、`result` は各キーと値のペアを確認し、条件を満たすものだけを追加することで構築されます。

import unittest

def _dynamic_test(test_case, condition, success_message, failure_message):
    if condition:
        test_case._testMethodName = success_message
        test_case.assertTrue(True, success_message)
    else:
        test_case._testMethodName = failure_message
        test_case.fail(failure_message)

class TestFilterProductsByBudget(unittest.TestCase):
    def test_products_within_budget(self):
        import user_code
        """Checks that only affordable products are returned."""
        try:
            result = user_code.filter_products_by_budget(100, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)
            expected_output = "Available products within budget: {'mouse': 50, 'keyboard': 90}"
            condition = result == expected_output
            failure_message = f"For input `(100, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)`, expected `{expected_output}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `filter_products_by_budget` is not defined."
        
        _dynamic_test(self, condition, "The function correctly filters products within budget.", failure_message)
    
    def test_no_affordable_products(self):
        import user_code
        """Checks that the function returns a message when no products are within budget."""
        try:
            result = user_code.filter_products_by_budget(10, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)
            expected_output = "No products available within the budget."
            condition = result == expected_output
            failure_message = f"For input `(10, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)`, expected `{expected_output}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `filter_products_by_budget` is not defined."
        
        _dynamic_test(self, condition, "The function correctly returns a message when no products are affordable.", failure_message)
    
    def test_all_products_affordable(self):
        import user_code
        """Checks that all products are returned if all are within budget."""
        try:
            result = user_code.filter_products_by_budget(500, mouse=50, keyboard=90, headphones=150)
            expected_output = "Available products within budget: {'mouse': 50, 'keyboard': 90, 'headphones': 150}"
            condition = result == expected_output
            failure_message = f"For input `(500, mouse=50, keyboard=90, headphones=150)`, expected `{expected_output}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `filter_products_by_budget` is not defined."
        
        _dynamic_test(self, condition, "The function correctly returns all products when all are affordable.", failure_message)

if __name__ == '__main__':
    unittest.main()

test_main.py

関数がPythonプログラミングにどのような影響を与えるかについての確かな理解を得ることができます。関数の定義と呼び出し、引数の操作、戻り値の処理、再帰やラムダ式を用いた柔軟で効率的なコードの作成を習得します。

関数とは何か、そしてなぜPythonで重要なのかを探求します。関数の作成方法、引数の定義、戻り値の処理、組み込み関数の効果的な使用方法について学びます。

Pythonにおける位置引数とオプション引数の仕組みを学びます。さまざまな入力に対応できる柔軟な関数を作成し、コードの柔軟性を向上させます。

可変長引数およびキーワード引数を使用して、入力サイズが異なる場合の処理方法を理解します。これらの手法によって、関数をより動的かつ整理されたものにする方法を学びます。

戻り値が関数の出力をどのように表すかを学びます。単一または複数の値の返却、Noneの使用、より高度なデータフロー制御のためのジェネレーターの活用について探求します。

再帰とラムダ関数による高度な関数の概念を習得します。再帰が繰り返しの問題をどのように解決するか、ラムダ式が簡潔な1行関数をどのように作成するかを学びます。

任意のキーワード引数

解答