Campus Livre
xlsread
Lê números e texto de uma planilha do Excel.
Categoria: Data Import and Analysis > Data Import and Export
Sintaxe
num = xlsread(filename)Lê os dados numéricos da primeira aba.
num = xlsread(filename, sheet)Lê uma aba dada por número ou nome.
num = xlsread(filename, sheet, range)Lê apenas as células de range, como 'B2:C3'.
[num, txt, raw] = xlsread(___)Também retorna as células de texto e o conteúdo bruto.
Descrição
xlsread separa a planilha em sua parte numérica e sua parte de texto. Uma linha de rótulos seguida de números dá um num sem o cabeçalho e um txt com os rótulos. Use raw quando precisar dos dois tipos nas posições originais.
A função é mantida para código antigo. readmatrix, readcell e readtable são as substitutas recomendadas, com mais controle sobre intervalos e tipos.
Argumentos de entrada
filename- Nome do arquivo de planilha.
sheet- Índice ou nome da aba.
range- Intervalo de células em notação A1.
Argumentos de saída
num- Matriz numérica. Células sem número viram
NaN, e linhas ou colunas iniciais de texto são removidas. txt- Cell array com as células de texto; as células numéricas aparecem como texto vazio.
raw- Cell array com todas as células exatamente como lidas, números e texto juntos.
Exemplos
Texto de cabeçalho e números
xlswrite('read_demo.xlsx', {'name','val'; 'a',1; 'b',2});
[num, txt, raw] = xlsread('read_demo.xlsx')Saída
num = 2×1
1
2
txt = 3×2 cell
{'name'} {'val' }
{'a' } {0×0 char}
{'b' } {0×0 char}
raw = 3×2 cell
{'name'} {'val'}
{'a' } {[ 1]}
{'b' } {[ 2]}Um intervalo de uma aba
xlswrite('range_demo.xlsx', magic(4));
xlsread('range_demo.xlsx', 1, 'B2:C3')Saída
ans = 2×2
11 10
7 6