ed/gencpp
1
0
Fork 0
mirror of https://github.com/Ed94/gencpp.git synced 2024-12-22 07:44:45 -08:00
Code Issues Packages Projects Releases Wiki Activity

Updated readme.

Browse Source
This commit is contained in:
Edward R. Gonzalez 2023-04-09 13:58:46 -04:00
parent 3647cdefd1
commit d5e6421b03
2 changed files with 26 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Readme.md
View File

@ -64,12 +64,12 @@ The user is given `Code` typed objects that are used to build up the AST.
Example using each construction interface: Example using each construction interface:
#### Upfrontl #### Upfront
```cpp ```cpp
Code t_uw = def_type( name(uw) ); Code t_uw = def_type( name(uw) );
Code t_allocator = def_type( name(allocator) ); Code t_allocator = def_type( name(allocator) );
Code t_string_cosnt = def_type( name(char), def_specifiers( 3, ESpecifier::Const, ESpeciifer::Ptr ) ); Code t_string_cosnt = def_type( name(char), def_specifiers( 2, ESpecifier::Const, ESpecifier::Ptr ) );
Code header; Code header;
{ {
@ -133,8 +133,7 @@ Code header = untyped_str(
``` ```
`name` is a helper macro for providing a string literal with its size, intended for the name paraemter of functions. `name` is a helper macro for providing a string literal with its size, intended for the name paraemter of functions.
`code` is a helper macro for providing a string literal with its size, but intended for a code string parameters. `code` is a helper macro for providing a string literal with its size, but intended for code string parameters.
All three constrcuton interfaces will generate the following C code: All three constrcuton interfaces will generate the following C code:
@ -151,7 +150,7 @@ struct ArrayHeader
## Gen's DSL ## Gen's DSL
If you don't mind a low amount of macros (29 lines), a DSL may be optionally defined with: If you don't mind a low amount of macros (61 sloc), a DSL may be optionally defined with:
```cpp ```cpp
GEN_DEFINE_DSL GEN_DEFINE_DSL
@ -372,7 +371,7 @@ Interface :
Usage: Usage:
```cpp ```cpp
Code <name> = parse_<function name>( string with code ); Code <name> = parse_<function name>( <string with code> );
Code <name> = def_<function name>( ..., parse_<function name>( Code <name> = def_<function name>( ..., parse_<function name>(
<string with code> <string with code>
@ -539,7 +538,7 @@ However, if:
* You enjoy actually *seeing* the generated code instead of just the error symbols or the pdb symbols. * You enjoy actually *seeing* the generated code instead of just the error symbols or the pdb symbols.
* You value your debugging expereince, and would like to debug your metaprogram, without having to step through the debug version of the compiler (if you even can) * You value your debugging expereince, and would like to debug your metaprogram, without having to step through the debug version of the compiler (if you even can)
* Want to roll your own reflection system * Want to roll your own reflection system
* Want to maintain a series of libraries for internal use, but don't want to deal with manaual merging as often when they update. * Want to maintain a series of libraries for internal use, but don't want to deal with manual merging as often when they update.
* Want to create tailored headers for your code or for your libraries since you usually don't need the majority of the code within them. * Want to create tailored headers for your code or for your libraries since you usually don't need the majority of the code within them.
Then this might help you boostrap a toolset todo so. Then this might help you boostrap a toolset todo so.

20
gencpp.code-workspace Normal file
View File

@ -0,0 +1,20 @@
{
"folders": [
{
"path": "."
}
],
"settings": {
"files.associations": {
"*.rmd": "markdown",
"array": "cpp",
"compare": "cpp",
"type_traits": "cpp",
"utility": "cpp",
"xtr1common": "cpp",
"xutility": "cpp",
"initializer_list": "cpp",
"table.h": "c"
}
}
}