Python-VBA函数之旅-setattr函数

目录

一、setattr函数的常见应用场景

二、setattr函数使用注意事项

三、如何用好setattr函数？

1、setattr函数：

1-1、Python：

1-2、VBA：

2、推荐阅读：

个人主页： https://blog.csdn.net/ygb_1024?spm=1010.2135.3001.5421

一、setattr函数的常见应用场景

        setattr函数在Python中有广泛的应用场景，特别是在动态实现类属性或方法、元编程(metaprogramming)以及处理对象时不知道具体属性名的情况下，常见的应用场景有：

1、动态实现类属性或方法：当你不确定类的所有属性或方法时，可以在运行时使用setattr()函数动态地添加它们，这可以用于创建可扩展的类，或者根据外部配置动态地添加功能。

2、简化对象属性的批量设置：如果你有一个对象，并且需要从字典或其他数据源中设置多个属性，setattr()函数可以帮助你简化这个过程。

3、实现代理对象或装饰器：在代理对象或装饰器模式中，你可能需要拦截对某个对象的属性访问，并在访问之前或之后执行一些操作，你可以使用setattr()函数来动态地修改被代理对象的属性。

4、结合描述符(Descriptors)使用：描述符是Python中一个强大的特性，允许你控制对对象属性的访问，当描述符与setattr()函数结合使用时，你可以实现更复杂的属性访问逻辑。

5、序列化和反序列化：在处理自定义对象的序列化和反序列化时，setattr()函数可以帮助你根据序列化的数据动态地设置对象的属性，这在处理JSON、XML或其他格式的数据时特别有用。

6、元编程：在元编程中，你编写操作其他代码的代码，setattr()函数允许你动态地修改对象的结构，这在创建代理、装饰器、元类等高级编程概念时非常有用。

7、处理用户输入：如果你正在编写一个接受用户输入并动态设置对象属性的程序，setattr()函数可以帮助你根据用户输入来设置属性。

        注意，过度使用setattr()函数可能会使代码难以理解和维护，因为它破坏了对象的明确性和封装性，因此，在使用setattr()函数时应该谨慎，并确保你的代码清晰、可读和可维护。

二、setattr函数使用注意事项

        在Python中，setattr()是一个内置函数，用于设置对象的属性值，它的基本用法是setattr(object, name, value)，其中，object是你想要修改其属性的对象，name是属性的名称(作为一个字符串)，而value是你想要设置的新值。

在使用setattr()函数时，需注意以下事项：

1、属性名称作为字符串：name参数必须是一个字符串，它指定了你想要设置的属性的名称，如果你尝试使用一个非字符串值，Python会抛出一个TypeError异常。
2、不存在的属性：如果对象没有名为name的属性，setattr()会创建一个新的属性，但是，如果你试图设置一个只读属性(如某些内置类型或扩展类型中的属性)，可能会引发异常。
3、隐藏或覆盖内置方法：如果你使用setattr()函数设置了一个与对象现有方法同名的属性，那么这个方法将被该属性隐藏或覆盖，这可能会导致意外的行为，特别是如果后来你尝试调用那个方法但忘记了已经被覆盖。
4、动态属性：虽然setattr()函数允许你动态地设置对象的属性，但这并不意味着你应该滥用它，过度使用动态属性可能会使代码难以理解和维护，在可能的情况下，最好明确地在类定义中声明属性。
5、安全性：setattr()函数可以被用于修改对象的任何属性，包括私有属性(在Python中，以双下划线开头的属性名称被认为是私有的)，这可能会破坏对象的内部状态，并导致不可预测的行为，因此，在使用setattr()函数时，你应该非常小心，确保你只修改你真正想要修改的属性。
6、异常处理：在设置属性时，可能会发生各种异常，如AttributeError(如果尝试访问不存在的属性)或TypeError(如果属性类型与赋值不兼容)，你应该准备好处理这些异常，以防止程序崩溃。
7、性能：虽然setattr()函数在大多数情况下都足够快，但在某些情况下，频繁地使用它可能会导致性能问题，如果你需要频繁地设置大量属性，可能需要考虑其他更高效的方法。
8、结合getattr()/delattr()使用：getattr()/delattr()是另外两个与setattr()相关的内置函数，它们分别用于获取和删除对象的属性，在编写处理对象属性的代码时，这三个函数通常会一起使用。

三、如何用好setattr函数？

        要在Python中妥善使用setattr()函数，你需遵循以下建议：

1、明确目的：首先，确定你为何需要使用setattr()函数？在大多数情况下，直接在类定义中声明属性或使用常规的赋值语法是更简单、更直观的选择，如果你确实需要动态地设置属性，那么setattr()函数是一个有用的工具。

2、避免覆盖内置方法：在调用setattr()函数时，确保你没有意外地覆盖对象的内置方法或属性，你可以通过检查name参数的值来避免这种情况。

3、考虑封装：如果你经常需要动态地设置属性，可以考虑将setattr()的调用封装到一个类或方法中，这样可以隐藏底层复杂性，并提供一个更清晰的接口给调用者。

4、使用字典代替属性：如果你需要存储大量的动态属性，并且不关心它们作为对象的属性暴露给外部代码，那么使用字典来存储这些属性可能是一个更好的选择。字典提供了灵活的键值对存储，并且你可以使用dict.get(), dict.setdefault() 和dict.update()等方法来操作它们。

5、处理异常：当使用setattr()函数时，要准备好处理可能发生的异常，如AttributeError(如果尝试访问不存在的属性)或TypeError(如果赋值类型不兼容)，你可以使用try/except块来捕获这些异常，并相应地处理它们。

6、文档化：如果你在你的代码中使用setattr()函数，确保在相关的文档或注释中解释清楚它的用途和潜在的影响，这可以帮助其他开发者更好地理解你的代码，并避免意外的副作用。

7、测试：编写测试用例来验证你使用setattr()函数的代码的正确性。确保你的测试覆盖了各种情况，包括正常情况和异常情况，这可以帮助你发现潜在的问题，并确保你的代码在所有预期的情况下都能正常工作。

8、谨慎使用：尽管setattr()函数在某些情况下很有用，但它也可能导致代码难以理解和维护，因此，你应该谨慎地使用它，并确保你的代码在不需要动态属性时仍然能够正常工作。

1、setattr函数：

1-1、Python：

# 1.函数：setattr# 2.功能：用于设置对象的属性值# 3.语法：setattr(object, name, value)# 4.参数：# 4-1、object：对象# 4-2、name：字符串，表示对象属性# 4-3、value：属性值# 5.返回值：无# 6.说明：# 7.示例：# 用dir()函数获取该函数内置的属性和方法print(dir(setattr))# ['__call__', '__class__', '__delattr__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__',# '__getstate__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__le__', '__lt__', '__module__', '__name__',# '__ne__', '__new__', '__qualname__', '__reduce__', '__reduce_ex__', '__repr__', '__self__', '__setattr__', '__sizeof__',# '__str__', '__subclasshook__', '__text_signature__']# 用help()函数获取该函数的文档信息help(setattr)# 应用一：动态实现类属性或方法# 示例1：动态设置类实例的属性class MyClass:    def __init__(self):        self.existing_attribute = 'I exist!'# 创建一个类的实例instance = MyClass()# 使用setattr()动态地添加一个属性setattr(instance, 'my_weight', '70.6kg')# 访问动态添加的属性print(instance.my_weight)# 70.6kg# 示例2：动态设置类的方法class MyClass:    def existing_method(self):        print('I am an existing method!')# 创建一个类的实例instance = MyClass()# 定义一个要动态添加的方法def dynamic_method(self):    print('I am a dynamically added method!')# 使用setattr()动态地添加一个方法setattr(MyClass, 'dynamic_method', dynamic_method)# 在类的实例上调用动态添加的方法(注意：我们是在类上添加的方法，所以所有实例都可以访问)instance.dynamic_method()# I am a dynamically added method!# 示例3：动态设置类的属性(即类变量)class MyClass:    existing_class_variable = 'I am a class variable!'# 使用setattr()动态地添加一个类变量setattr(MyClass, 'dynamic_class_variable', 'I was dynamically added as a class variable!')# 访问动态添加的类变量(通过类本身或其实例)print(MyClass.dynamic_class_variable)  # 输出: I was dynamically added as a class variable!print(MyClass().dynamic_class_variable)  # 同样输出: I was dynamically added as a class variable!# I was dynamically added as a class variable!# I was dynamically added as a class variable!# 应用二：简化对象属性的批量设置class Person:    def __init__(self):        self.name = None        self.age = None        self.city = None# 创建一个Person实例person = Person()# 使用字典来存储要设置的属性值attributes = {    'name': 'Myelsa',    'age': 18,    'city': 'Guangzhou'}# 使用setattr()批量设置属性for key, value in attributes.items():    setattr(person, key, value)# 验证属性是否设置成功print(person.name)print(person.age)print(person.city)# Myelsa# 18# Guangzhou# 应用三：实现代理对象或装饰器class Proxy:    def __init__(self, obj):        self._obj = obj    def __setattr__(self, name, value):        # 检查是否是要拦截的属性        if name.startswith('_'):            # 如果以'_'开头，则直接设置到代理对象本身            super().__setattr__(name, value)        else:            # 否则，拦截对_obj属性的设置，并可能添加一些额外的逻辑            print(f"Intercepted setattr for {name}. Original value: {getattr(self._obj, name, 'None')}")            # 在这里可以添加一些逻辑，比如验证、转换等            # ...            # 设置值到_obj            setattr(self._obj, name, value)            print(f"Set {name} to {value} in the original object.")    def __getattr__(self, name):        # 如果访问的属性不存在于代理对象本身，则转发到_obj        return getattr(self._obj, name)class MyClass:    def __init__(self):        self.x = 10# 创建一个MyClass实例和一个代理对象obj = MyClass()proxy = Proxy(obj)# 尝试设置代理对象的属性proxy.x = 20# 尝试访问代理对象的属性print(proxy.x)# Intercepted setattr for x. Original value: 10# Set x to 20 in the original object.# 20# 应用四：结合描述符(Descriptors)使用class BoundedDescriptor:    def __init__(self, name, lower=None, upper=None):        self.name = name        self.lower = lower        self.upper = upper        self._value = None    def __get__(self, instance, owner):        if instance is None:            return self        return self._value    def __set__(self, instance, value):        if self.lower is not None and value  self.upper:            raise ValueError(f"{self.name} must be less than or equal to {self.upper}")        self._value = value        print(f"Setting {self.name} to {value}")    def __delete__(self, instance):        raise AttributeError("Cannot delete the descriptor")class MyClass:    x = BoundedDescriptor('x', 0, 10)# 创建一个MyClass的实例obj = MyClass()# 使用setattr()设置属性(这实际上是调用描述符的__set__方法)setattr(obj, 'x', 5)  # 输出: Setting x to 5print(obj.x)  # 输出: 5# 尝试设置一个超出范围的值try:    setattr(obj, 'x', -1)except ValueError as e:    print(e)  # 输出: x must be greater than or equal to 0# 尝试删除描述符（会引发异常）try:    delattr(obj, 'x')except AttributeError as e:    print(e)  # 输出: Cannot delete the descriptor# Setting x to 5# 5# x must be greater than or equal to 0# Cannot delete the descriptor# 应用五：序列化和反序列化class Person:    def __init__(self, name, age):        self.name = name        self.age = age    def __repr__(self):        return f"Person(name={self.name}, age={self.age})"def serialize_person(person):    """将Person对象序列化为字典"""    return {        'name': person.name,        'age': person.age    }def deserialize_person(data):    """从字典反序列化为Person对象"""    person = Person(None, None)  # 创建一个空的Person对象    for key, value in data.items():        setattr(person, key, value)  # 使用setattr()设置属性    return person# 示例用法# 序列化person = Person("Myelsa", 18)serialized_data = serialize_person(person)print(serialized_data)# 反序列化deserialized_person = deserialize_person(serialized_data)print(deserialized_person)# {'name': 'Myelsa', 'age': 18}# Person(name=Myelsa, age=18)# 应用六：元编程class DynamicClass:    def __init__(self):        # 用于存储动态方法的字典        self._dynamic_methods = {}    def add_method(self, name, func):        """动态地添加一个方法到类中"""        setattr(self, name, func)        # 同时将方法存储在字典中以便后续可能的操作        self._dynamic_methods[name] = func    def remove_method(self, name):        """动态地移除一个方法"""        if hasattr(self, name):            delattr(self, name)            if name in self._dynamic_methods:                del self._dynamic_methods[name]    def list_methods(self):        """列出所有的动态方法(不包括内置方法)"""        return list(self._dynamic_methods.keys())# 示例函数def hello_world():    print("Hello, world!")def greet(name):    print(f"Hello, {name}!")# 创建一个DynamicClass的实例dynamic_instance = DynamicClass()# 动态地添加一个方法dynamic_instance.add_method('hello', hello_world)# 调用动态添加的方法dynamic_instance.hello()  # 输出: Hello, world!# 列出所有的动态方法print(dynamic_instance.list_methods())  # 输出: ['hello']# 动态地添加另一个方法，这次使用lambda表达式dynamic_instance.add_method('greet_by_name', lambda name: greet(name))# 调用通过lambda添加的方法dynamic_instance.greet_by_name('Myelsa')  # 输出: Hello, Myelsa!# 移除一个方法dynamic_instance.remove_method('hello')# 再次列出所有的动态方法print(dynamic_instance.list_methods())  # 输出: ['greet_by_name']# 尝试调用已被移除的方法# dynamic_instance.hello()  # 这将引发 AttributeError# Hello, world!# ['hello']# Hello, Myelsa!# ['greet_by_name']# 应用七：处理用户输入class UserDefinedAttributes:    def __init__(self):        # 初始化一个空字典来存储用户定义的属性        self._user_attributes = {}    def set_attribute(self, name, value):        # 检查属性名是否以"user_"开头，以限制可设置的属性范围        if name.startswith("user_"):            # 使用setattr()来设置属性            setattr(self, name, value)            # 同时将属性存储在字典中，以便后续可能的操作或检查            self._user_attributes[name] = value            print(f"Attribute {name} set to {value}")        else:            print(f"Error: Cannot set attribute {name}. Only attributes starting with 'user_' are allowed.")    def get_attribute(self, name):        # 检查属性是否存在        if hasattr(self, name):            return getattr(self, name)        else:            print(f"Error: Attribute {name} does not exist.")            return None    def list_attributes(self):        # 列出所有用户定义的属性        return list(self._user_attributes.keys())# 示例用法obj = UserDefinedAttributes()# 获取用户输入name = input("Enter attribute name (must start with 'user_'): ")value = input("Enter attribute value: ")# 尝试设置属性obj.set_attribute(name, value)# 列出所有用户定义的属性print("User defined attributes:")for attr in obj.list_attributes():    print(f"{attr}: {obj.get_attribute(attr)}")# 尝试获取并打印一个属性attr_to_get = input("Enter attribute name to get (or 'exit' to quit): ")if attr_to_get.lower() != 'exit':    print(f"Value of {attr_to_get}: {obj.get_attribute(attr_to_get)}")else:    print("Exiting...")

1-2、VBA：

略，待后补。

2、推荐阅读：

2-1、Python-VBA函数之旅-round()函数

Python算法之旅：Algorithm

Python函数之旅：Functions

个人主页： 神奇夜光杯-CSDN博客