{"id":31918631,"url":"https://github.com/devd4v3/adynamic.h","last_synced_at":"2025-10-13T21:12:40.487Z","repository":{"id":103562314,"uuid":"179738059","full_name":"DevD4v3/aDynamic.h","owner":"DevD4v3","description":"Permite manipular arrays dinámicos de una forma más rápida para el programador.","archived":false,"fork":false,"pushed_at":"2019-09-06T22:38:18.000Z","size":60,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-23T02:42:49.660Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DevD4v3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-05T18:52:31.000Z","updated_at":"2019-09-06T22:31:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"380c09b0-2e25-4a32-813b-d0b6eeec303d","html_url":"https://github.com/DevD4v3/aDynamic.h","commit_stats":null,"previous_names":["devd4v3/adynamic.h"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/DevD4v3/aDynamic.h","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevD4v3%2FaDynamic.h","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevD4v3%2FaDynamic.h/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevD4v3%2FaDynamic.h/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevD4v3%2FaDynamic.h/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevD4v3","download_url":"https://codeload.github.com/DevD4v3/aDynamic.h/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevD4v3%2FaDynamic.h/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279017052,"owners_count":26085949,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-13T21:12:35.662Z","updated_at":"2025-10-13T21:12:40.479Z","avatar_url":"https://github.com/DevD4v3.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aDynamic.h\n[![aDynamic.h](https://shields.southcla.ws/badge/C-aDynamic.h-2f2f2f.svg?style=flat-square)](https://github.com/MrDave1999/aDynamic.h)\n\nCon este archivo de cabecera no tendrás que preocuparte en liberar la memoria a cada rato con la función free, porqué el include lo hace por ti, además de eso, te proporciona una sintaxis viable y entendible.\n\n# Instalación\n\nAgrega el fichero `aDynamic.h` en el directorio donde esté el código fuente del programa y lo incluyes de esta forma:\n```C\n#include \"aDynamic.h\"\n```\nSí vas a usar el include para varios programas, lo puedes agregar directamente en la carpeta `include` (la que viene por defecto en el IDE). Luego de eso, puedes incluir el archivo de esta forma:\n```C\n#include \u003caDynamic.h\u003e\n```\n\n# Requisitos\n\n- Para que el include funcione correctamente necesitas definir la macro `MAX_ARRAYS` antes de incluir `aDynamic.h`, de lo contrario, el compilador lanzará un error.\n```C\n#define MAX_ARRAYS 3 /* Aquí especificas la cantidad de arrays dinámicos que vayas a utilizar .*/\n#include \u003caDynamic.h\u003e /* Luego de eso, incluyes el archivo de cabecera */\n```\n\n- Las identificaciones de los arrays dinámicos deben empezar desde 0, de lo contrario, habrá desbordamiento de búfer y eso ocasionaría que el problema aborte.\n\n# Macros\n\n- `getsize(arrayid)`:\n\nObtiene la cantidad de elementos de un array dinámico.\n\n- `setsize(arrayid, value)`:\n\nAsigna una cantidad de elementos a un array dinámico.\n\n- `getal(typedata, arrayid, index)`:\n\nObtiene un elemento específico de un arreglo dinámico.\n\n- `setal(typedata, arrayid, index, value)`:\n\nAsigna un elemento específico a un arreglo dinámico.\n\n**Nota:** La macro getal y setal solo sirve para arreglos dinámicos que no sean declarados como estructura.\n\n- `getad(arrayid) *(buf_ptr2 + arrayid)`:\n\nObtiene la dirección de memoria del primer elemento de un arreglo dinámico. \n\n- `dmat_a(arrayid)`:\n\nLibera la memoria de un específico array dinámico.\n\n- `free_a()`:\n\nLibera la memoria de cada array dinámico que exista en el heap/montón.\n\n- `alloc_a(arrayid, nameptr)`:\t\n\nAsigna memoria para un array dinámico. \n  \n**Ejemplo:**\n```C\n#define MAX_ARRAYS 2 /* Especificamos la cantidad de arrays a crear */\n#include \u003caDynamic.h\u003e /* Incluimos el archivo de cabecera */\n\n/* La identificación de cada array debe comenzar desde 0 */\nenum\n{\n\tARRAY_ID1,\n\tARRAY_ID2\n};\n\nint main(void)\n{\n\t/* Asignamos el tamaño de elementos del array A y B */\n\tsetsize(ARRAY_ID1, 5);\n\tsetsize(ARRAY_ID2, 6);\n\t/* Asignamos memoria dinámicamente para crear el array A y B */\n\talloc_a(int, ARRAY_ID1);\n\talloc_a(int, ARRAY_ID2);\n\t/* La memoria se libera automáticamente */\n\treturn 0;\n}  \n```\nSí llega a ver algún fallo en la asignación de memoria, la macro `alloc_a` hace que la función main retorne 1.\n  \n**Nota:** En el primer argumento de `alloc_a` se especifica la ID del array.\n  \n- `realloc_a(arrayid, nameptr)`:\t\n\nRe-dimensiona el tamaño de un array dinámico.\n  \n**Ejemplo:**\n```C\n#define MAX_ARRAYS 2\n#include \u003caDynamic.h\u003e\n\nenum\n{\n\tARRAY_ID1,\n\tARRAY_ID2\n};\n\nint Array(const int arrayid, const int size)\n{\n\tsetsize(arrayid, size);\n\t/*\n\t\tCon esta macro podemos asignar memoria solo una vez y luego de eso,\n\t\tpodemos re-dimensionará el array\n\t*/\n\trealloc_a(float, arrayid);\n\treturn 0;\n}\n\nint main(void)\n{\n\tif (Array(ARRAY_ID1, 7) == 1) return 1;\n\tif (Array(ARRAY_ID2, 9) == 1) return 1;\n\t/* La memoria se libera automáticamente */\n\treturn 0;\n}\n```\nLa macro \"realloc_a\" hace que la función \"Array\" retorne 1 si es que hubo algún fallo en la re-asignación de memoria. Por esa razón     cuando llamamos la función \"Array\" agregamos esa condición para detectar si hay un error al momento de re-dimensionar.\n  \n- `error(namefunc, ...)`:\n\nPermite llamar una función cuando en esa misma subrutina se (re)asigna memoria.\n  \nEsta expresión:\n```C\nif (Array(ARRAY_ID1, 7) == 1) return 1;\n```\nEs equivalente a esto:\n```C\nerror(Array, ARRAY_ID1, 7);\n```\nLa mayoría de las macros llevan un guion bajo + una letra 'a', eso hace referencia a un \"array dinámico\".\n  \n# Uso\n\n```C\n#define MAX_ARRAYS 2\n#include \"aDynamic.h\"\n\nenum\n{\n\tAA,  //Array A\n\tAB  //Array B\n};\n\n/* Función que sirve para re-dimensionar el array B (AB) */\nint Re_DimensionarAB(void)\n{\n\tint i;\n\t/* Este código re-dimensiona el array B tres veces. */\n\tfor (setsize(AB, 1); getsize(AB) != 4; ++getsize(AB))\n\t{\n\t\trealloc_a(int, AB);\n\t\tfor (i = 0; i != getsize(AB); ++i)\n\t\t\tprintf(\"%d\\n\", \u0026getal(int, AB, i));\n\t\tprintf(\"\\n\");\n\t}\n\treturn 0;\n}\n\nint main(void)\n{\n\t/* Pedimos al usuario el tamaño de elementos del array A */\n\tprintf(\"Ingrese la cantidad de elementos del array A:\\n\");\n\tscanf(\"%d\", \u0026getsize(AA));\n\t/* Reservamos memoria para construir el array A */\n\talloc_a(char, AA);\n\t/* Imprime las direcciones de memoria de cada elemento del array A */\n\tfor (int i = 0; i != getsize(AA); ++i)\n\t\tprintf(\"%d\\n\", \u0026getal(int, AA, i));\n\n\tprintf(\"\\n\\n\");\n\t/* Llamamos la función y detectamos si hubo algún error en la asignación */\n\terror(Re_DimensionarAB);\n\n\t/* La memoria se libera automáticamente */\n\treturn 0;\n}\n```\nEn el siguiente enlace hay un programa completo aplicando `aDynamic.h`: [Ejemplo](https://github.com/MrDave1999/aDynamic.h/blob/master/Example/Example.c)\n\nPara la realización de ese programa se usó los siguientes header files:\n\n- [pscanf.h](https://github.com/MrDave1999/pscanf.h)\n- [assertx.h](https://github.com/MrDave1999/assertx.h)\n\n# Arrays de Estructuras\n\nArrays de estructuras son búfers contiguos. Eso quiere decir que sí hago esto:\n```C\n#define MAX_ARRAYS 2\n#include \u003caDynamic.h\u003e\n```\nEs como si tuviera 2 búfers contiguos de X elementos. Miremos el siguiente ejemplo:\n```C\n#define MAX_ARRAYS 1 /* Solo quiero un búfer contiguo */\n#include \u003caDynamic.h\u003e\n#include \u003cstdint.h\u003e\n\nenum ID_ARRAY\n{\n\tARRAY_A //La ID del primer búfer contiguo\n};\n\n/* Los elementos de cada búfer contiguo */\nstruct _tipo\n{\n\tfloat a;\n\tint b;\n\tchar c;\n};\n\n/* Asignamos un alias al nombre de la estructura \"_tipo\" */\ntypedef struct _tipo tipo;\n\nuint8_t Array(void)\n{\n\ttipo* aux;\n\t/* Asignamos el tamaño del array de estructura */\n\tsetsize(ARRAY_A, 5);\n\t/* Reservamos memoria para 5 buffers contiguos */\n\talloc_a(tipo, ARRAY_A);\n\taux = getad(ARRAY_A);\n\tfor (int i = 0; i != getsize(ARRAY_A); ++i)\n\t{\n\t\taux[i].a = 2.9f;\n\t\taux[i].b = 5;\n\t\taux[i].c = 'a';\n\t}\n\t/* Re-dimensionamos el array de estructura a 2 buffers */\n\tsetsize(ARRAY_A, 2);\n\trealloc_a(tipo, ARRAY_A);\n\treturn 0;\n}\n\nint main(void)\n{\n\ttipo* pa;\n\t/* Pasamos la dirección de memoria del puntero PA */\n\terror(Array);\n\tpa = getad(ARRAY_A);\n\tprintf(\"\\n\");\n\tprintf(\"[Updates]: data Array A:\\n\\n\");\n\tfor (int i = 0; i != getsize(ARRAY_A); ++i)\n\t{\n\t\tprintf(\"%f\\n\", pa[i].a);\n\t\tprintf(\"%d\\n\", pa[i].b);\n\t\tprintf(\"%c\\n\", pa[i].c);\n\t\tprintf(\"\\n\");\n\t}\n\t/* La memoria se libera automáticamente */\n\treturn 0;\n}\n```\n**Nota:** Búfers contiguo significa que varios búfer estarán juntos entre sí, por esa razón es posible usar esta sintaxis para acceder/modificar algún miembro de cualquier búfer.\n```C\npa[i].a = 9;\n```\n\n# Créditos\n\n- [MrDave](https://github.com/MrDave1999) \n\t- Por el desarrollo de aDynamic.h\n- [Microsoft Corporation](https://github.com/Microsoft) \n\t- Se usó el compilador `cl.exe` para poder compilar los códigos de prueba, de ese modo se comprueba sí no hubo algún error.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevd4v3%2Fadynamic.h","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevd4v3%2Fadynamic.h","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevd4v3%2Fadynamic.h/lists"}