Comando Linux indent
Manual completo de comandos Linux
El comando Linux indent se utiliza para ajustar el formato de los archivos de código fuente en C.
indent puede identificar archivos de código fuente en C y formatearlos para facilitar su lectura a los programadores.
Sintaxis
indent [参数][源文件] o indent [参数][源文件][-o 目标文件]
Parámetros:
- -bad o --blank-lines-after-declarations Agregar líneas en blanco después de las secciones de declaración.
- -bap o --blank-lines-after-procedures Agregar líneas en blanco después de los procedimientos.
- -bbb o --blank-lines-after-block-comments Agregar líneas en blanco después de los comentarios en bloque.
- -bc o --blank-lines-after-commas En las secciones de declaración, si aparece una coma, saltar de línea.
- -bl o --braces-after-if-line Si if (o else, for, etc.) y la "{" del bloque de ejecución siguiente están en líneas distintas, y "}" ocupa su propia línea.
- -bli<número de espacios de sangría> o --brace-indent<número de espacios> Establece el número de espacios de sangría para { }.
- -br o --braces-on-if-line if (o else, for, etc.) y la "{" del bloque de ejecución siguiente están en la misma línea, y "}" ocupa su propia línea.
- -bs o --blank-before-sizeof Dejar un espacio después de sizeof.
- -c<número de columna> o --comment-indentation<número de columna> Coloca los comentarios en la columna especificada a la derecha del código.
- -cd<número de columna> o --declaration-comment-column<número de columna> Coloca los comentarios en la columna especificada a la derecha de las declaraciones.
- -cdb o --comment-delimiters-on-blank-lines Los símbolos de comentario ocupan su propia línea.
- -ce o --cuddle-else Coloca "else" después de "}" (el fin del bloque de ejecución de if).
- -ci<número de espacios> o --continuation-indentation<número de espacios> Cuando una línea es demasiado larga y se divide, especifica el número de espacios de sangría después del salto de línea.
- -cli<número de espacios> o --case-indentation-<número de espacios> El número de espacios de sangría para "case" en un "switch".
- -cp<número de columna> o -else-endif-column<número de columna> Coloca los comentarios en la columna especificada a la derecha de las sentencias "else" y "elseif".
- -cs o --space-after-cast Dejar un espacio después de una conversión de tipo (cast).
- -d<número de espacios> o -line-comments-indentation<número de espacios> Para los comentarios que no están a la derecha del código, establece su sangría.
- -di<número de columna> o --declaration-indentation<número de columna> Coloca las variables de la sección de declaración en la columna especificada.
- -fc1 o --format-first-column-comments Establece el formato de los comentarios que están al inicio de cada línea.
- -fca o --format-all-comments Establece el formato de todos los comentarios.
- -gnu o --gnu-style Usa el formato de GNU, que es el valor predeterminado.
- -i<número de espacios> o --indent-level<número de espacios> Establece el número de espacios de sangría.
- -ip<número de espacios> o --parameter-indentation<número de espacios> Establece la sangría de los parámetros.
- -kr o --k-and-r-style Usa el formato de Kernighan & Ritchie.
- -lp o --continue-at-parentheses Cuando una sentencia es demasiado larga y se divide, y contiene paréntesis, alinea verticalmente el inicio de cada línea dentro de los paréntesis.
- -nbad o --no-blank-lines-after-declarations No agregar líneas en blanco después de las secciones de declaración.
- -nbap o --no-blank-lines-after-procedures No agregar líneas en blanco después de los procedimientos.
- -nbbb o --no-blank-lines-after-block-comments No agregar líneas en blanco después de los comentarios en bloque.
- -nbc o --no-blank-lines-after-commas En las secciones de declaración, incluso si aparece una coma, no saltar de línea.
- -ncdb o --no-comment-delimiters-on-blank-lines Los símbolos de comentario no deben ocupar su propia línea.
- -nce o --dont-cuddle-else No colocar "else" después de "}".
- -ncs o --no-space-after-casts No dejar un espacio después de una conversión de tipo (cast).
- -nfc1 o --dont-format-first-column-comments No formatear los comentarios que están al inicio de cada línea.
- -nfca o --dont-format-comments No formatear ningún comentario.
- -nip o --no-parameter-indentation No sangrar los parámetros.
- -nlp o --dont-line-up-parentheses Cuando una sentencia es demasiado larga y se divide, y contiene paréntesis, no es necesario alinear verticalmente el inicio de cada línea dentro de los paréntesis.
- -npcs o --no-space-after-function-call-names No agregar un espacio después del nombre de la función invocada.
- -npro o --ignore-profile No leer el archivo de configuración .indent.pro de indent.
- -npsl o --dont-break-procedure-type Poner el tipo de procedimiento y el nombre del procedimiento en la misma línea.
- -nsc o --dont-star-comments No agregar asteriscos (*) al lado izquierdo de los comentarios.
- -nsob o --leave-optional-semicolon No procesar las líneas en blanco adicionales.
- -nss o --dont-space-special-semicolon Si el bloque de for o while tiene una sola línea, no agregar un espacio antes del punto y coma.
- -nv o --no-verbosity No mostrar información detallada.
- -orig o --original Usar el formato de Berkeley.
- -pcs o --space-after-procedure-calls Agregar un espacio entre el nombre de la función invocada y "{".
- -psl o --procnames-start-lines Poner el tipo de procedimiento en la línea anterior al nombre del procedimiento.
- -sc o --start-left-side-of-comments Agregar un asterisco (*) al lado izquierdo de cada línea de comentario.
- -sob o --swallow-optional-blank-lines Eliminar las líneas en blanco adicionales.
- -ss o --space-special-semicolon Si el bloque de for o while tiene una sola línea, agregar un espacio antes del punto y coma.
- -st o --standard-output Mostrar el resultado en el dispositivo de salida estándar.
- -T Sangrar los nombres de tipos de datos.
- -ts<número de espacios> o --tab-size<número de espacios> Establece la longitud del tabulador.
- -v o --verbose Mostrar información detallada durante la ejecución.
- -version Mostrar información de la versión.
Explicación del formato de código Indent
| Parámetros de indent utilizados | Valor | Significado |
|---|---|---|
| --blank-lines-after-declarations | bad | Agregar línea en blanco después de las declaraciones de variables. |
| --blank-lines-after-procedures | bap | Agregar línea en blanco después del final de la función. |
| --blank-lines-before-block-comments | bbb | Agregar línea en blanco antes de los comentarios en bloque. |
| --break-before-boolean-operator | bbo | Las líneas largas se dividen antes de los operadores lógicos. |
| --blank-lines-after-commas | nbc | En las declaraciones de variables, no dividir las variables separadas por comas. |
| --braces-after-if-line | bl | Poner "if" y "{" en dos líneas. |
| --brace-indent 0 | bli0 | "{" no continúa la sangría. |
| --braces-after-struct-decl-line | bls | Al definir estructuras, "struct" y "{" van en líneas separadas. |
| --comment-indentationn | c33 | Los comentarios después de una sentencia comienzan en la columna 33. |
| --declaration-comment-columnn | cd33 | Los comentarios después de las declaraciones de variables comienzan en la columna 33. |
| --comment-delimiters-on-blank-lines | ncdb | No convertir comentarios de una sola línea en comentarios de bloque. |
| --cuddle-do-while | ncdw | El "while" de "do --- while" y la "}" anterior van en una línea aparte. |
| --cuddle-else | nce | "else" y la "}" anterior van en una línea aparte. |
| --case-indentation 0 | cli0 | Las sentencias "case" en un "switch" se sangran 0 espacios. |
| --else-endif-columnn | cp33 | Los comentarios después de #else y #endif comienzan en la columna 33. |
| --space-after-cast | cs | Añadir espacio después de la conversión de tipo |
| --line-comments-indentation n | d0 | Comentarios de una sola línea (que no comiencen en la columna 1), no sangrar a la izquierda |
| --break-function-decl-args | nbfda | Desactivado: los parámetros de la función van uno por línea |
| --declaration-indentationn | di2 | Declaración de variables, las variables comienzan en la línea 2, es decir, no es necesario alinearlas |
| --format-first-column-comments | nfc1 | No formatear los comentarios que comienzan en la primera línea |
| --format-all-comments | nfca | No activar el interruptor para formatear todos los comentarios |
| --honour-newlines | hnl | Prefer to break long lines at the position of newlines in the input. |
| --indent-leveln | i4 | Establecer cuántos caracteres de sangría; si es múltiplo entero de tab, usar tab para sangrar; de lo contrario, rellenar con espacios. |
| --parameter-indentationn | ip5 | En las definiciones de funciones de estilo antiguo, la descripción de parámetros se sangra 5 espacios |
| --line-length 75 | l75 | Las líneas que no son comentarios tienen un máximo de 75 caracteres |
| --continue-at-parentheses | lp | Las líneas continuadas comienzan desde el paréntesis que aparece en la línea anterior |
| --space-after-procedure-calls | pcs | Insertar un espacio entre la función y "(" |
| --space-after-parentheses | nprs | No insertar espacios después de "(" ni antes de ")" |
| --procnames-start-lines | psl | Definir el nombre de la función y el tipo de retorno en dos líneas |
| --space-after-for | saf | Espacio después de for |
| --space-after-if | sai | Espacio después de if |
| --space-after-while | saw | Espacio después de while |
| --start-left-side-of-comments | nsc | No añadir * en los comentarios de bloque generados |
| --swallow-optional-blank-lines | nsob | No eliminar las líneas en blanco que se puedan añadir |
| --space-special-semicolon | nss | En las sentencias for o while de una sola línea, no añadir espacio antes de ";" |
| --tab-size | ts4 | Un tab equivale a 4 espacios (debe ser divisible por "-in") |
| --use-tabs | ut | Usar tab para la sangría |