matlab.metadata.Namespace Class

Namespace: matlab.metadata
Superclasses: matlab.metadata.MetaData

Describe MATLAB namespace

Renamed from meta.package in R2024a

Description

The matlab.metadata.Namespace class contains information about MATLAB^® namespaces. All properties are read-only.

Namespaces can contain classes, functions, and contained namespaces (referred to as inner namespaces). A namespace can also itself be contained by an outer namespace.

The matlab.metadata.Namespace class is a handle class.

Class Attributes

Sealed	true
Abstract	true
RestrictsSubclassing	true
HandleCompatible	true
Hidden	true

For information on class attributes, see Class Attributes.

Creation

A matlab.metadata.Namespace object can be obtained from the Namespace property of matlab.metadata.Class.

Properties

Name — Namespace

character vector

Namespace, returned as a character vector.

Description — Short description of namespace

character vector

Short description of the namespace, returned as a character vector.

DetailedDescription — Not used

empty character vector

This property is not used.

ClassList — List of classes that are scoped to this namespace

matlab.metadata.Class array

List of classes that are scoped to this namespace, returned as an array of matlab.metadata.Class objects.

FunctionList — List of functions that are scoped to this namespace

matlab.metadata.Method array

List of functions that are scoped to this namespace, returned as an array of matlab.metadata.Method objects.

InnerNamespaces — List of inner namespaces contained by this namespace

matlab.metadata.Namespace array

List of inner namespaces that are contained by this namespace, returned as an array of matlab.metadata.Namespace objects.

OuterNamespace — Outer namespace that contains this namespace

matlab.metadata.Namespace object

Outer namespace that contains this namespace, returned as a matlab.metadata.Namespace object. If this namespace is not contained in another namespace, the matlab.metadata.Namespace object is empty.

Methods

Public Methods

The two methods of Namespace are no longer recommended. To get information about the contents of namespaces, use namespaceClasses, namespaceFunctions, and innerNamespaces instead. (since R2026a)

matlab.metadata.Namespace.fromName	(Not recommended) Return matlab.metadata.Namespace object for specified namespace
matlab.metadata.Namespace.getAllNamespaces	(Not recommended) Get all top-level namespaces

Examples

Get Details About Namespaces

Create a metaclass instance of matlab.mixin.Heterogeneous.

x = ?matlab.mixin.Heterogeneous

x = 

  Class with properties:

                     Name: 'matlab.mixin.Heterogeneous'
              Description: 'Enable heterogeneous array formation'
      DetailedDescription: ''
                   Hidden: 0
                   Sealed: 0
                 Abstract: 1
              Enumeration: 0
          ConstructOnLoad: 0
         HandleCompatible: 1
          InferiorClasses: [0×1 matlab.metadata.Class]
                Namespace: [1×1 matlab.metadata.Namespace]
                  Aliases: [0×1 string]
     RestrictsSubclassing: 0
             PropertyList: [0×1 matlab.metadata.Property]
               MethodList: [5×1 matlab.metadata.Method]
                EventList: [0×1 matlab.metadata.Event]
    EnumerationMemberList: [0×1 matlab.metadata.EnumerationMember]
           SuperclassList: [0×1 matlab.metadata.Class]

Access the Namespace property to get information about the matlab.mixin namespace. The results include what classes, functions, and inner namespaces are contained in matlab.mixin.

x.Namespace

ans = 

  Namespace with properties:

                   Name: 'matlab.mixin'
            Description: 'matlab.mixin'
    DetailedDescription: ''
              ClassList: [9×1 matlab.metadata.Class]
           FunctionList: [1×1 matlab.metadata.Method]
        InnerNamespaces: [4×1 matlab.metadata.Namespace]
         OuterNamespace: [1×1 matlab.metadata.Namespace]

Version History

Introduced in R2008a

R2026a: Class is hidden

matlab.metadata.Namespace and its two public methods, matlab.metadata.Namespace.fromName and matlab.metadata.Namespace.getAllNamespaces, are hidden. The behavior remains the same, but the two methods are no longer recommended. To get information about the contents of namespaces, use namespaceClasses, namespaceFunctions, and innerNamespaces instead

R2024a: Namespace, class, methods, and properties renamed

As of R2024a, the namespace, class name, methods, and some properties of meta.package have been renamed. Their behavior remains the same.

• The new namespace is matlab.metadata.

• The new class name is Namespace.

• The two static methods of this class use the new namespace and class name. Also, meta.package.getAllPackages is now matlab.metadata.Namespace.getAllNamespaces.

• Some of the properties of this class have new names.

  Name in R2023b and Earlier	New Name as of R2024a
  ContainingPackage	OuterNamespace
  Packages	InnerNamespaces

MATLAB will continue to recognize the old metaclass names in most contexts. However, code that relies on string comparisons to identify metaclasses might need to be updated to continue to work as expected. For example, if mObj in the example below is a matlab.metadata.Namespace instance, the code under the case statement for 'meta.package' does not execute because class(mObj) returns 'matlab.metadata.Namespace'.

switch class(mObj)
   case 'meta.package'
       % code to execute if mObj is a meta.package instance
   ...
end

To ensure this code continues to work as intended, use an if statement with isa. The isa command recognizes both the old and new names of the class.

if isa(mObj,'meta.package') 
       % code to execute if mObj is a matlab.metadata.Namespace instance
   else
       ...
   end

If compatibility with older releases of MATLAB is not a concern, you can update 'meta.package' to 'matlab.metadata.Namespace'. However, continue to use the old name if your code needs to run on versions of MATLAB before R2024a.