convertStringsToChars

Преобразуйте строковые массивы в символьные массивы, оставив другие массивы неизменными

Описание

При работе с собственным кодом можно использовать convertStringsToChars заставить ваш код принять входные параметры строки. Затем вы не должны вносить никакие другие изменения в код, который вы записали, чтобы работать с символьными массивами.

пример

B = convertStringsToChars(A) преобразует A к вектору символов или массиву ячеек из символьных векторов, если A массив строк. В противном случае, convertStringsToChars возвращает A неизменный.

пример

[B1,...,Bn] = convertStringsToChars(A1,...,An) преобразует любые строковые массивы в A1,...,An к векторам символов или массивам ячеек из символьных векторов, и затем возвращает их как соответствующие выходные аргументы в B1,...,Bn. Если любой из аргументов A1,...,An имеет любой другой тип данных, затем convertStringsToChars возвращает его неизменный.

Примеры

свернуть все

Создайте строковый скаляр и преобразуйте его в вектор символов.

str = "Mercury"
str = 
"Mercury"
chr = convertStringsToChars(str)
chr = 
'Mercury'

Преобразуйте массив строк в массив ячеек из символьных векторов.

str = ["Venus","Earth","Mars"]
str = 1x3 string
    "Venus"    "Earth"    "Mars"

C = convertStringsToChars(str)
C = 1x3 cell
    {'Venus'}    {'Earth'}    {'Mars'}

Обработайте произвольное число входных массивов различных типов, преобразовав только строковые массивы в символьные массивы.

Создайте ряд числового, символ и строковые массивы.

A = [1 2 3]
A = 1×3

     1     2     3

str = ["Mercury","Gemini","Apollo"]
str = 1x3 string
    "Mercury"    "Gemini"    "Apollo"

B = [2 5; 7 6]
B = 2×2

     2     5
     7     6

C = {'volts','amps'}
C = 1x2 cell
    {'volts'}    {'amps'}

Преобразуйте массив строк и возвратите другие неизменные массивы.

[newA,newStr,newB,newC] = convertStringsToChars(A,str,B,C)
newA = 1×3

     1     2     3

newStr = 1x3 cell
    {'Mercury'}    {'Gemini'}    {'Apollo'}

newB = 2×2

     2     5
     7     6

newC = 1x2 cell
    {'volts'}    {'amps'}

Входные параметры

свернуть все

Входной массив в виде массива любого размера или типа данных.

Выходные аргументы

свернуть все

Выходной массив. Тип данных выходного массива зависит от типа данных входного массива, A.

  • Если A строковый скаляр, затем B вектор символов.

  • Если A массив строк любого другого размера, затем B массив ячеек из символьных векторов, который имеет тот же размер.

  • Если A имеет любой другой тип данных, затем B идентично A.

Если A массив строк, затем convertStringsToChars преобразует любой элемент, который является:

  • Пустая строка (отображенный как "") к 0- 0 символьный массив (отображенный как '')

  • Отсутствующая строка (отображенный как <missing>) к 0- 0 массив символов

Если A массив пустой строки, затем B массив пустой ячейки. Пустой массив имеет по крайней мере одну размерность, размером которой является 0.

Советы

  • Чтобы позволить вашему существующему коду принять строковые массивы как вход, добавьте вызов convertStringsToChars в начале вашего кода.

    Например, если вы задали функциональный myFunc это принимает три входных параметра, процесс все три входных использования convertStringsToChars. Оставьте остальную часть вашего кода неизменной.

    function y = myFunc(a,b,c)
        [a,b,c] = convertStringsToChars(a,b,c);
        <line 1 of original code>
        <line 2 of original code>
        ...

    В этом примере, выходные аргументы [a,b,c] перезапишите входные параметры на месте. Если какой-либо входной параметр не является массивом строк, то это неизменно.

    Если myFunc принимает переменное количество входных параметров, затем процесс все аргументы, заданные varargin.

    function y = myFunc(varargin)
        [varargin{:}] = convertStringsToChars(varargin{:});
        ...
  • convertStringsToChars функция более эффективна при преобразовании одного входного параметра. Если эффективность является беспокойством, то вызовите convertStringsToChars на одном входном параметре за один раз, вместо того, чтобы вызвать его однажды на нескольких входных параметрах.

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Введенный в R2017b
Для просмотра документации необходимо авторизоваться на сайте