Nombres y reglas de nomenclatura
Este capítulo abarca la codificación de nombres de objetos y nombres de carpetas, así como las reglas de nomenclatura aplicables y las carpetas reservadas para CODESYS File-Based Storage.
Codificación de nombres
Los nombres de objetos y carpetas a veces contienen caracteres que no están permitidos en las rutas del sistema de archivos o que tienen un significado especial. Estos caracteres están codificados por CODESYS File-Based Storage para que el proyecto siga siendo compatible entre Windows y Linux.
Se codifican los siguientes caracteres:
Caracteres que Windows no permite en una ruta:
< > : " / \ | ? *Circunferencia (
^) porque identifica los directorios de contenedoresTodos los personajes de control
Período (
.) porque separa el nombre de la parte de la clase y la parte del idioma
Cada carácter codificado se escribe como dos guiones bajos seguidos del código hexadecimal de dos dígitos del carácter. Así, el punto se convierte en __2e, la barra se convierte en __2f y el acento circunflejo se convierte en __5e.
Si el nombre de un objeto coincide con un nombre de dispositivo reservado de Windows, entonces el nombre se encierra entre guiones bajos. Los nombres de dispositivos reservados de Windows son: CON, PRN, AUX, NUL, COM1 a COM9, y LPT1 a LPT9. CON se convertirá _CON_.
Reglas de nomenclatura
Para garantizar que los proyectos sigan siendo portátiles y adecuados para los sistemas de control de versiones, CODESYS File-Based Storage Se comprobarán los nombres de los objetos. Se informará de las infracciones.
El nombre del objeto, incluyendo el sufijo de clase y el sufijo de idioma, no debe exceder los 240 caracteres. El nombre de la carpeta tampoco debe exceder los 240 caracteres.
Los nombres de los objetos no deben contener un símbolo de almohadilla (
#).Los nombres de los objetos no deben comenzar ni terminar con un espacio en blanco.
Dos carpetas no pueden tener el mismo nombre, ni siquiera en distintas partes del proyecto. La comparación no distingue entre mayúsculas y minúsculas.
Un objeto de programación no debe contener dos métodos con el mismo nombre.
Un proyecto no debe hacer referencia a dos bibliotecas que utilicen el mismo espacio de nombres.
Si CODESYS Si se detecta una infracción durante una conversión, se informará del problema. Si es posible, se proporcionará una solución rápida. Convertir proyecto El comando describe las soluciones rápidas disponibles.
Carpetas reservadas
Varias carpetas son utilizadas por CODESYS File-Based Storage para fines internos, incluyendo .FBS_Project_Related, .auxiliaries, y .sidecars No cree carpetas de proyecto con estos nombres.
El .auxiliaries y .sidecars Las carpetas incluyen contenido local o generado. Excluya siempre estas carpetas de los sistemas de control de versiones.