Class variable

In class-based, object-oriented programming, a class variable is a variable defined in a class of which a single copy exists, regardless of how many instances of the class exist.[1][2][3][4][5]

A class variable is not an instance variable. It is a special type of class attribute (or class property, field, or data member). The same dichotomy between instance and class members applies to methods ("member functions") as well; a class may have both instance methods and class methods.

Static member variables and static member functions

In some languages, class variables and class methods are either statically resolved, not via dynamic dispatch, or their memory statically allocated at compile time (once for the entire class, as static variables), not dynamically allocated at run time (at every instantiation of an object). In other cases, however, either or both of these are dynamic. For example, if classes can be dynamically defined (at run time), class variables of these classes are allocated dynamically when the class is defined, and in some languages class methods are also dispatched dynamically.

Thus in some languages, static member variable or static member function are used synonymously with or in place of "class variable" or "class function", but these are not synonymous across languages. These terms are commonly used in Java, C#,[5] and C++, where class variables and class methods are declared with the static keyword, and referred to as static member variables or static member functions.

Examples

C++

class Order {
private:
    inline static int nextId = 0;
    int id;
public:
    Order():
        id{nextId++} {}
};

In this C++ example, the class variable Order::nextId is incremented on each call to the constructor, so that Order::nextId always holds the number of Orders that have been constructed, and each new Order object is given a number in sequential order. Since nextId is a class variable, there is only one object Order::nextId; in contrast, each Order object contains its own distinct id field.

Also note that the variable Order::nextId is initialized only once (as inline static, it is initialized inside the class; prior to C++17, it was only static and had to be initialized outside the class).

A class with static members that are instances of itself can only declare the fields const first while the constexpr declarations must reside outside the class. Trying to use declare a constexpr instance of a class as a static member of itself fails as no definition of an object may be an incomplete type, which the class is incomplete until it is closed.[6]

struct Color {
    uint8_t r;
    uint8_t g;
    uint8_t b;

    constexpr Color(uint8_t r, uint8_t g, uint8_t b) noexcept:
        r{r}, g{g}, b{b} {}

    constexpr ~Color() = default;

    static const Color BLACK;
    static const Color RED;
    static const Color GREEN;
    static const Color YELLOW;
    static const Color BLUE;
    static const Color MAGENTA;
    static const Color CYAN;
    static const Color WHITE;
};

inline constexpr Color Color::BLACK = Color(0, 0, 0);
inline constexpr Color Color::RED = Color(255, 0, 0);
inline constexpr Color Color::GREEN = Color(0, 255, 0);
inline constexpr Color Color::YELLOW = Color(255, 255, 0);
inline constexpr Color Color::BLUE = Color(0, 0, 255);
inline constexpr Color Color::MAGENTA = Color(255, 0, 255);
inline constexpr Color Color::CYAN = Color(0, 255, 255);
inline constexpr Color Color::WHITE = Color(255, 255, 255);

Python

class Dog:
    vertebrate_group: str = "mammals" # class variable

dog: Dog = Dog()
print(dog.vertebrate_group) # accessing the class variable

In the above Python code, it does not provide much information as there is only class variable in the Dog class that provide the vertebrate group of dog as mammals. In instance variable, one can customize the object (in this case, dog) by having one or more instance variables in the Dog class.

This can also be type hinted using ClassVar.

from typing import ClassVar

class Dog:
    vertebrate_group: ClassVar[str] = "mammals"

Notes

  1. ^ "The Java Tutorial, Variables". Retrieved 2010-10-21.
  2. ^ "The Java Tutorial, Understanding Instance and Class Members". Retrieved 2010-10-21.
  3. ^ "The Python Language Reference, Compound Statements". Retrieved 2010-10-21.
  4. ^ "Objective-C Runtime Reference". Apple Developer. Retrieved 1 April 2018.
  5. ^ a b "Class Variables in C#". Syntaxdb. Retrieved 1 April 2018.
  6. ^ WG21 (23 April 2026). "Draft C++ Standard - Declarations and definitions". eel.is. WG21. In the definition of an object, the type of that object shall not be an incomplete type ([basic.types.general]), an abstract class type ([class.abstract]), or a (possibly multidimensional) array thereof.{{cite web}}: CS1 maint: numeric names: authors list (link)

Content Disclaimer

Informasi ini disarikan dari Wikipedia dan disajikan kembali untuk tujuan edukasi. Konten tersedia di bawah lisensi CC BY-SA 3.0. Kami tidak bertanggung jawab atas ketidakakuratan data yang bersumber dari kontribusi publik tersebut.

  1. The information displayed on this website is sourced in part or in whole from Wikipedia and has been adapted for the purpose of restating it. We strive to provide accurate and relevant information, however:
  2. There is no guarantee of absolute accuracy. Wikipedia is an open, collaborative project that can be edited by anyone, so information is subject to change.
  3. It is not intended to constitute professional advice. The content displayed is for informational and educational purposes only. For important decisions (e.g., medical, legal, or financial), please consult a professional.
  4. Content copyright. Wikipedia is licensed under the Creative Commons Attribution-ShareAlike License (CC BY-SA). This means that content may be reused with appropriate attribution and shared under a similar license.
  5. Responsible use. Any risk arising from the use of information from this website is entirely the responsibility of the user.