extractAll (J1939)

Occurrences of specified J1939 parameter groups

Syntax

extractedPGs = extractAll(pgrp,pgname)

[extractedPGs,remainderPGs] = extractAll(pgrp,pgname)

Description

extractedPGs = extractAll(pgrp,pgname) returns all parameter groups whose name occurs in pgname.

[extractedPGs,remainderPGs] = extractAll(pgrp,pgname) also returns a parameter group array, remainder, containing all groups from the original array not matching the specified names in pgname.

Examples

Extract Parameter Groups

Extracts all the parameter groups with a name of 'PG1' or 'PG2'.

extractedPGs = extractAll(pgrp,{'PG1' 'PG2'})

Extract Parameter Groups and Remainder

Extract all parameter groups with a name of 'PG1' or 'PG2', and also return unmatched parameter groups to a different array.

[extractedPGs,remainderPGs] = extractAll(parameterGroups, {'PG1' 'PG2'})

Input Arguments

pgrp — J1939 parameter group

array of ParameterGroup objects

J1939 parameter groups, specified as an array of ParameterGroup objects. Use thej1939ParameterGroup or receive function to create ParameterGroup objects.

pgname — Names of J1939 parameter groups to extract

char vector | string | cell array of char vectors

Names of J1939 parameter groups to extract, specified as a character vector, string, or array of these.

Example: 'PG1'

Data Types: char | string | cell

Output Arguments

extractedPGs — Extracted parameter groups

array of ParameterGroup objects

Extracted parameter groups, returned as an array of ParameterGroup objects. These parameter groups have names matching any of those specified in the pgname argument.

remainderPGs — Remainder of parameter groups

array of ParameterGroup objects

Remainder of parameter groups, returned as an array of ParameterGroup objects. These are all the parameter groups with names not matching any of those specified in the pgname argument.