rmfield

Remove fields from structure

Syntax

s = rmfield(s,field)

Description

s = rmfield(s,field) removes the specified field or fields from structure array s. Specify multiple fields using a cell array of character vectors or a string array. The dimensions of s remain the same.

Examples

Remove Single Field

Define a scalar structure with fields named a, b, and c.

s.a = 1;
s.b = 2;
s.c = 3;

Remove field b.

field = 'b';
s = rmfield(s,field)

s = struct with fields:
    a: 1
    c: 3

Remove Multiple Fields

Define a scalar structure with fields first, second, third, and fourth.

S.first = 1;
S.second = 2;
S.third = 3;
S.fourth = 4;

Remove fields first and fourth.

fields = {'first','fourth'};
S = rmfield(S,fields)

S = struct with fields:
    second: 2
     third: 3

Input Arguments

s — Input structure

structure array

Input structure, specified as a structure array.

Data Types: struct

field — Field name or names

character array | cell array of character vectors | string array

Field name or names, specified as a character array, cell array of character vectors, or string array.

Example: 'f1'

Example: {'f1';'f2'}

Data Types: char | cell | string

Extended Capabilities

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a