Local Classes in C++

3.2

A class declared inside a function becomes local to that function and is called Local Class in C++. For example, in the following program, Test is a local class in fun().

#include<iostream>
using namespace std;

void fun()  
{
      class Test  // local to fun
      {
        /* members of Test class */
      };
}

int main()
{
    return 0;
}



Following are some interesting facts about local classes.
1) A local class type name can only be used in the enclosing function. For example, in the following program, declarations of t and tp are valid in fun(), but invalid in main().

#include<iostream>
using namespace std;

void fun()  
{       
      // Local class 
      class Test  
      {
        /* ... */      
      };

      Test t;  // Fine
      Test *tp;  // Fine
}

int main()
{
    Test t;  // Error
    Test *tp;  // Error
    return 0;
}



2) All the methods of Local classes must be defined inside the class only. For example, program 1 works fine and program 2 fails in compilation.

// PROGRAM 1
#include<iostream>
using namespace std;

void fun()  
{
    class Test  // local to fun
    {
    public:
  
       // Fine as the method is defined inside the local class   
       void method() {
          cout << "Local Class method() called";
       }
    };      

    Test t;
    t.method();  
}

int main()
{
    fun();
    return 0;
}

Output:

Local Class method() called
// PROGRAM 2
#include<iostream>
using namespace std;

void fun()
{
    class Test  // local to fun
    {
    public:
        void method();
    };
    
    // Error as the method is defined outside the local class
    void Test::method()
    {
        cout << "Local Class method()";
    }
}

int main()
{
    return 0;
}

Output:

Compiler Error:
 In function 'void fun()':
 error: a function-definition is not allowed here before '{' token



3) A Local class cannot contain static data members. It may contain static functions though. For example, program 1 fails in compilation, but program 2 works fine.

// PROGRAM 1
#include<iostream>
using namespace std;

void fun()  
{
      class Test  // local to fun
      {
         static int i;
      };
}

int main()
{
    return 0;
}
Compiler Error:
 In function 'void fun()':
 error: local class 'class fun()::Test' shall not have static data member 'int fun()::Test::i'
// PROGRAM 2
#include<iostream>
using namespace std;

void fun()
{
    class Test  // local to fun
    {
    public:
        static void method()
        {
            cout << "Local Class method() called";
        }
    };

    Test::method();
}

int main()
{
    fun();
    return 0;
}

Output:

Local Class method() called



4) Member methods of local class can only access static and enum variables of the enclosing function. Non-static variables of the enclosing function are not accessible inside local classes. For example, the program 1 compiles and runs fine. But, program 2 fails in compilation.

// PROGRAM 1
#include<iostream>
using namespace std;

void fun()  
{
      static int x;
      enum {i = 1, j = 2};

      // Local class
      class Test
      {
        public:
          void method() {
              cout << "x = " << x << endl;   // fine as x is static
              cout << "i = " << i << endl;   // fine as i is enum
          }
      };

      Test t;
      t.method();
}

int main()
{
    fun();
    return 0;
}

Output:

x = 0
i = 1
// PROGRAM 2
#include<iostream>
using namespace std;

void fun()  
{
      int x;

      // Local class
      class Test
      {
        public:
          void method() {
              cout << "x = " << x << endl;
          }
      };

      Test t;
      t.method();
}

int main()
{
    fun();
    return 0;
}

Output:

  In member function 'void fun()::Test::method()':
  error: use of 'auto' variable from containing function



5) Local classes can access global types, variables and functions. Also, local classes can access other local classes of same function.. For example, following program works fine.

#include<iostream>
using namespace std;

int x;

void fun()  
{

      // First Local class
      class Test1 {
      public:
         Test1() { cout << "Test1::Test1()" << endl; }
      };

      // Second Local class
      class Test2
      {
           // Fine: A local class can use other local classes of same function
           Test1 t1;
      public:
          void method() {
              // Fine: Local class member methods can access global variables.
              cout << "x = " << x << endl;
          }
      };

      Test2 t;
      t.method();
}

int main()
{
    fun();
    return 0;
}

Output:

Test1::Test1()
x = 0

Also see Nested Classes in C++

References:
Local classes (C++ only)
Local Classes

Please write comments if you find anything incorrect, or you want to share more information about the topic discussed above.

GATE CS Corner    Company Wise Coding Practice

Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.

Recommended Posts:



3.2 Average Difficulty : 3.2/5.0
Based on 14 vote(s)










Writing code in comment? Please use ide.geeksforgeeks.org, generate link and share the link here.