ForHosting KIT · Texto e IA

Transpor linhas e colunas CSV

name,age,city sobre Ada,36,London e Bob,41,Paris vira name,Ada,Bob, depois age,36,41 e city,London,Paris: cada linha passa a ser uma coluna. Linhas curtas recebem células vazias e vírgulas entre aspas são mantidas. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Dados CSV: name,age,city Ada,36,London Bob,41,Paris

Você obtém

Dados CSV: name,Ada,Bob age,36,41 city,London,Paris
Linhas: 3
Colunas: 3
Linhas originais: 3

Transpor uma tabela CSV significa que cada linha vira coluna e cada coluna vira linha, de modo que uma exportação larga fica alta e uma alta fica larga sem reescrever células à mão. Analistas usam essa inversão quando a planilha chegou com métricas em linhas em vez de colunas, quando uma ferramenta de gráfico quer as séries na primeira coluna, ou quando um layout no estilo pivô precisa ser desfeito antes de um join. Esta capacidade analisa CSV no estilo RFC 4180, preenche linhas curtas para a grade ficar retangular, troca índices e grava de volta a tabela transposta com o mesmo delimitador e as aspas corretas.

O que significa transpor linhas e colunas de um CSV

Um arquivo CSV é uma grade mais ou menos retangular: registros separados por quebras de linha e campos separados por um delimitador, na maioria das vezes uma vírgula. Transpor essa grade é a mesma troca de forma conhecida da álgebra linear, aplicada a células de texto em vez de números. A primeira linha de entrada vira a primeira coluna de saída; a primeira coluna de entrada vira a primeira linha de saída.

Uma tabela três por dois vira duas por três. Cabeçalhos não são especiais: se a primeira linha é name, age, city, esses rótulos passam para a primeira coluna do resultado, exatamente o que a maioria das buscas de «virar esta planilha» deseja. A definição só funciona quando todas as linhas compartilham a mesma contagem de colunas.

Exportações reais costumam ser irregulares — uma linha sem o campo vazio final, outra com uma vírgula a mais —, então esta ferramenta preenche linhas curtas com strings vazias até a linha mais larga, em vez de inventar dados ou descartar células. Campos entre aspas seguem RFC 4180: uma célula que contém o delimitador, aspas duplas ou uma quebra de linha continua sendo uma célula, e uma aspa embutida é escrita como duas aspas. Prefira esta landing transpose-csv-rows-and-columns quando a intenção for uma inversão pura de orientação.

Contrato de entrada, regras de aspas e campos da resposta

O delimiter opcional tem vírgula como padrão; use um único caractere ou a grafia comum de tabulação para TSV. Um campo só é citado na saída quando contém o delimitador, aspas, CR ou LF, para identificadores simples permanecerem compactos. Linhas em branco na origem são ignoradas; células vazias são mantidas, inclusive uma célula vazia inicial após a inversão.

Exemplo: name,age e depois Ada,36 viram name,Ada na primeira linha do resultado e age,36 na segunda. Use csv quando precisar de um arquivo para baixar ou colar; use cells quando um cliente for renderizar uma tabela sem analisar de novo.

Casos de uso

Inverta uma exportação mensal larga

Cole uma planilha em que cada mês é uma coluna, transponha para que cada mês seja uma linha e leve a tabela alta a um gráfico ou a um join.

Corrija um dump de pesquisa de lado

Ferramentas de pesquisa às vezes emitem um respondente por coluna. Transponha o CSV para que cada pessoa seja uma linha antes da análise.

Perguntas frequentes

Como transpor linhas e colunas de um CSV?

O campo csv da resposta é a tabela invertida; cells é a mesma grade como arrays. O delimiter opcional tem vírgula como padrão.

O que acontece com a linha de cabeçalho?

A primeira linha vira a primeira coluna. Rótulos como name, age e city passam para a primeira coluna de saída, que é a inversão usual de planilha.

Como linhas desiguais são tratadas?

Linhas curtas são preenchidas com strings vazias até a linha mais larga para a transposição permanecer retangular. Nenhuma célula é descartada e nenhum valor é inventado além desses vazios.

Ele conserva vírgulas dentro de campos entre aspas?

Sim. A análise e a escrita seguem RFC 4180: campos citados podem conter o delimitador, aspas (duplicadas) e quebras de linha.

A ferramenta para transpor CSV é gratuita?

A ferramenta do navegador roda grátis no seu dispositivo.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/str/csv-transpose

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/str/csv-transpose \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"name,age,city\nAda,36,London\nBob,41,Paris"}'

const res = await fetch("https://api.kit.forhosting.com/str/csv-transpose", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "csv": "name,age,city\nAda,36,London\nBob,41,Paris"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/csv-transpose",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "csv": "name,age,city\nAda,36,London\nBob,41,Paris"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/csv-transpose", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"csv":"name,age,city\\nAda,36,London\\nBob,41,Paris"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"csv":"name,age,city\nAda,36,London\nBob,41,Paris"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/csv-transpose", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "csv": "name,age,city\nAda,36,London\nBob,41,Paris"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.csv_transpose",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Entrada vazia, aspas sem fechar e tabelas grandes demais falham com invalid_input em vez de devolver meia grade em silêncio. Chamadas API bem-sucedidas são cobradas a US$ 0,002; falhas de validação não são cobradas.

O que significa transpor linhas e colunas de um CSV

Não a use para filtrar linhas, renomear muitas colunas, unir dois arquivos ou converter uma tabela inteira em JSON aninhado — são intenções de produto distintas. O caminho é totalmente determinístico: o mesmo texto CSV e o mesmo delimitador sempre produzem o mesmo JSON, sem rede, semente aleatória nem relógio de parede.

Contrato de entrada, regras de aspas e campos da resposta

Envie um corpo JSON com o campo de string obrigatório csv igual ao texto não vazio da tabela. Os alias text, input, data, source, content e value são aceitos para o corpo CSV. Falta de csv, csv vazio, csv que não seja string, um delimitador que não seja exatamente um caractere, um delimitador que seja aspas ou quebra de linha, campos entre aspas sem fechar e tabelas que ultrapassem os limites de tamanho documentados disparam invalid_input com uma mensagem que nomeia o problema, e essas falhas não são cobradas na API pré-paga. Em sucesso a resposta inclui csv como o texto da tabela transposta com separadores de linha LF e aspas RFC 4180, cells como a mesma grade em forma de arrays, rows e cols para a forma do resultado, original_rows e original_cols para a forma de entrada (original_cols é a largura máxima antes do preenchimento), delimiter ecoando o separador usado, e method sempre csv_transpose.

Uso da API, preços, fluxos de trabalho e limites práticos

Use a ferramenta gratuita no navegador para transpor CSV quando precisar inverter uma tabela de dever de casa, uma exportação de CRM ou um dump de métricas sem abrir uma planilha nem escrever um script improvisado. Um fluxo típico cola uma exportação larga com os meses no topo, transõe para que cada mês seja uma linha e então envia o resultado a um gráfico ou a um join. Não espere detecção automática de delimitador, inferência de tipos nem um motor completo de tabela dinâmica com agregações — são problemas diferentes. Autores que publicam SDKs podem documentar csv como obrigatório, mostrar um exemplo de sucesso com linha de cabeçalho e um erro de csv ausente para que integradores vejam os dois lados do contrato. Use a API pré-paga do KIT quando um CMS, um passo ETL, um harness de QA, um app de tutoria ou um cliente móvel precisarem do mesmo contrato com saldo a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo depois que o motor rejeita o pedido. Combine este endpoint com extract-csv-column, filter-csv ou csv-to-json quando o próximo passo for uma lista de um único campo, um filtro de linhas ou um array de objetos, mas mantenha transpor CSV como landing própria para não misturar a inversão de orientação com transformações que renomeiam ou calculam colunas. Mantenha os payloads em tamanhos de documento comuns, adequados a um isolate de Worker, e não dumps de data warehouse de vários megabytes.

Casos de integração

Fixtures golden para analisadores CSV

Scripts de CI fixam uma amostra citada e irregular e afirmam o csv e cells transpostos para que aspas e preenchimento não regridam em silêncio.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que significa transpor linhas e colunas de um CSV

Contrato de entrada, regras de aspas e campos da resposta

Casos de uso

Inverta uma exportação mensal larga

Corrija um dump de pesquisa de lado

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

O que significa transpor linhas e colunas de um CSV

Contrato de entrada, regras de aspas e campos da resposta

Uso da API, preços, fluxos de trabalho e limites práticos

Casos de integração

Fixtures golden para analisadores CSV

obrigado