foundational_lib 1.0

data/Articles_MD/11.html.md

@@ -0,0 +1,231 @@
+---
+title: The Solution of Foundationallib
+---
+
+The Solution of Foundationallib
+===============================
+
+By G.C.
+-------
+
+\# foundationallib
+
+Finally, a cross-platform, portable, well-designed, secure, robust, maximally-efficient C foundational library --- Making Engineering And Computing Fast, Secure, Responsive And Easy.
+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
+
+\
+
+*Library Uses - What It Does, What It Is, And What It Is A Solution For*
+------------------------------------------------------------------------
+
+-   **Enables better Engineering Solutions and Security broadly and
+    foundationally where Software Creation or Development or Script
+    Creation is concerned - whether this be on a local, business,
+    governmental or international basis, and makes things easier - and
+    Computing in General.** Don\'t Reinvent the Wheel - Use Good
+    Wheels - Be Safe And Secure.
+-   **Enables a free-flowing dynamic computer usage that you need,
+    deserve and should have, simply because you have a computer. With
+    full speed and with robustness. You deserve to be able to use your
+    computer wholly and fully, with proper and fast operations.**
+-   **Enables flexibility and power - makes C accessible to the masses
+    (and faster and more secure) with easy usage and strives to bring
+    people up, not degrade the character or actions of people.** This is
+    a fundamental and unequivocal philosophy difference between this
+    library and many subsections of Software Engineering and the
+    mainstream engineering establishment. For instance, in Python, you
+    cannot read a file easily -- you have to read it line-by-line or
+    open a file, read the lines, then close it. With this library, you
+    can efficiently read 10,000 files in one function call. This library
+    gives power. Any common operation, there ought to be a powerful
+    function for.\
+    \
+    We should not bitch around with assembly when we don\'t want to; we
+    should also have full speed. Some old \"solutions\" deliver neither,
+    then culturally degrade programmers because their tools are bad -
+    actually, it just degrades programmers, and gives them bad tools.
+    COBOL is an example \...\
+    \
+    Human technology is about empowerment -- people must fight for it to
+    be empowerment, we don\'t have time to have AI systems kill us
+    because we want to have bad tools and be weak. We must fight.
+
+\
+
+-   →**Cross platform** - works perfectly in embedded, server, desktop,
+    and all platforms - tested for Windows and UNIX - 64-bit and 32-bit,
+    includes a 3-aspect test suite, with more to come.
+
+-   →**Bug free. Reliable. Dependable. Secure. Tested well.**
+
+-   →**Zero Overhead** - Only 1 byte due to the power of the error
+    handling, can be configured will full power.
+
+-   →**Static Inline Functions if you want them** (optional) -
+    Eliminating function call overhead to 0 if you wish, for improved
+    performance.
+
+-   →**Custom allocators** - if you want it.
+
+-   →**Custom error handling** - if you want it.
+
+-   →**Safe functions** warn the programmer about NULL values and unused
+    return values. Can be configured to not compile if not Secure.
+    Optional null-check macros in every library function. Does not use
+    any of
+    `"gets", "fgets", "strcpy", "strcat", "sprintf", "vsprintf", "scanf", "fscanf", "system", "chown", "chmod", "chgrp", "alloca", "execl", "execle", "execlp", "execv", "execve", "execvp", "bcopy", "bzero"`.
+    You can configure it to never use any unsafe functions.
+
+-   →**Portable** - works on all platforms, using platform specific
+    features (using \#ifdefs) to make functions better and faster. For
+    example, from testing, on Linux it uses \_\_builtin\_memcpy, which
+    can be 3.33 times faster than default memcpy().
+
+-   →**Multithreading support** (optional), with
+    list\_comprehension\_multithreaded (accepts any number of threads,
+    works in parallel using portable C11 threads)
+
+-   →**Networking support** (optional), using libcurl - making it
+    extremely easy to download websites and arrays of websites -
+    features other languages do not have.
+
+-   →Very good and thorough **Error Handling** and **allocation
+    overflow** checking (good for **Security and Robustness**) in the
+    functions. Allows the programmer to dynamically choose to catch all
+    errors in the functions with a handler (default or custom), or to
+    ignore them. No need to ALWAYS say \"if (\.....) if you don\'t want
+    to. Can be changed at runtime.
+
+-   →**Public Domain** so you make the code how you want. (No need to
+    \"propitiate\" to some \"god\" of some library).
+
+-   →**Minimal abstractions or indirection of any kind or needless slow
+    things that complicate things** - macros, namespace collision,
+    typedefs, structs, object-orientation messes, slow compilation
+    times, bloat, etc., etc.
+
+-   →**No namespace pollution** - you can generate your [**own
+    version**]{style="font-style:normal;"} with any prefix you like!
+
+-   →**Relies [minimally]{style="font-style:normal;"} on C libraries -
+    it can be fully decoupled from LIB C and can be statically linked.**
+
+-   →[**Very small**]{style="font-style:normal;"} - 13K Lines of Code
+    (including Doxygen comments and following of Best Practices)
+
+-   →**No Linkage Issues or dependency hell**
+
+-   →**Thorough and clear documentation**, with examples of usage.
+
+-   →**No licensing restrictions whatsoever - use it for your
+    engineering project, your startup, your Fortune 500 company, your
+    personal project, your throw-away script, your government.**
+
+-   →**Makes C like Python or Perl or Ruby in many ways - or more easy**
+
+-   →**Easy Straightforward Transpilation Support** - to make current
+    code, much faster - all without any bloat (See
+    transpile\_slow\_scripting\_into\_c.rb).
+
+-   #### In many cases, there is now a direct mapping of functions from other languages into optimized C. See the example script in this repository. This makes optimizing your Python / Perl / Ruby / PHP etc. script very easy, either manually or through the use of AI.
+
+::: {.pane style="border: 0;border-right: 1px dotted rgb(200, 200, 200); background-color: rgb(255, 255, 190);"}
+::: {.library-details}
+*Foundationallib Features* {#foundationallib-features style="color:green;"}
+--------------------------
+
+**Functional Programming Features** - `map, reduce, filter,` List
+Comprehensions in C and much more!
+
+**Expands C\'s Primitives for easy manipulation of data types** such as
+Arrays, Strings, `Dict`, `Set`, `FrozenDict`, `FrozenSet` - **and
+enables easy manipulation, modification, alteration, comparison,
+sorting, counting, IO (printing) and duplication of these at a very
+comfortable level** - something very, very rare in C or C++, *all
+without any overhead.*
+
+**More comfortable IO** - read and write entire files with ease, and
+convert complex types into strings or print them on the screen with
+ease.
+
+**A powerful general purpose Foundational Library** - *which has
+anything and everything you need* - from `replace_all()` to
+`replace_memory()` to `find_last_of()` to to `list_comprehension()` to
+`shellescape()` to `read_file_into_string()` to `string_to_json()` to
+`string_to_uppercase()` to `to_title_case()` to `read_file_into_array()`
+to `read_files_into_array()` to `map()` to `reduce()` to `filter()` to
+`list_comprehension_multithreaded()` to `frozen_dict_new_instance()` to
+`backticks()` - everything you would want to make quick and optimally
+efficient C programs, this has it.
+
+::: {style="height: 1px; border: 0;border-bottom: 1px dashed rgb(200, 200, 200);"}
+:::
+
+Helps to make programs hundreds of times faster than other languages
+with similar ease of creation.
+
+------------------------------------------------------------------------
+
+**Easily take advantage of CPU cores with
+list\_comprehension\_multithreaded()**.\
+\
+You can specify the number of threads, the transform and the filter
+functions, and this will transform your data - all in parallel. Don\'t
+have a multithreaded environment? Then disable it (set the flag).
+
+------------------------------------------------------------------------
+
+### You don\'t want to be reinventing the wheel and hoping that your memory allocation is secure enough - and then failing. **Security Is Paramount.**
+
+### You don\'t want to be waiting [a day]{style="color:rgb(240, 0, 0);"} for an operation to complete when it could take [less than an hour]{style="color:rgb(30, 30, 255);"}.
+
+\
+
+This library is founded on very strong and unequivocal goals and
+philosophy. In fact, I have written many articles about the foundation
+of this library and more relevantly the broader context. See the
+Articles folder - for some of the foundation of this library.
+
+\
+
+This library is an ideal and a dream - not just a Software Library. As
+such, I would highly suggest that you support me in this mission. Even
+if it\'s different from the status quo.\
+Are you a Rust or Zig fan? Then make a Rust or Zig version of this
+ideal. Let\'s go. Give me an email.
+:::
+:::
+
+\
+No Copyright - Public Domain - 2023, Gregory Cohen DONATION REQUEST: If
+this free software has helped you and you find it valuable, please
+consider making a donation to support the ongoing development and
+maintenance of this project. Your contribution helps ensure the
+availability of this library to the community and encourages further
+improvements. Donations can be made at:
+https://www.paypal.com/paypalme/cfoundationallib Note: The best way to
+contact me is through email, not social media. Please feel very free to
+email me if you want to express feedback, suggest an improvement, desire
+to collaborate on this free and open source project, want to support me,
+or want to create something great. Complacency and obstructionism and
+whining are not tolerated. I desire to make this library the best
+theoretically possible, so please, let us connect.
+
+This code is in the public domain, fully. You can do whatever you want with it. See docs.html for API reference. ![](https://github.com/gregoryc/foundationallib/raw/main/tools/pic.png)
+========================================================================================================================================================================================
+
+Here\'s some examples of some things you can do easily with Foundationallib.  
+============================================================================
+
+### Use it for scripting purposes\...
+
+![](https://github.com/gregoryc/foundationallib/raw/main/tools/pic2.png)
+
+Take control of the Web - in C.  
+===============================
+
+![](https://github.com/gregoryc/foundationallib/raw/main/tools/pic3.png)
+
+::: {.article_link}
+[Previous article](10.html) [Next article](12.html)
+:::

data/Articles_MD/12.html.md

@@ -0,0 +1,16 @@
+---
+title: Nonsense
+---
+
+Nonsense
+========
+
+By G.C.
+-------
+
+There is a lot of nonsense in the world and in the mainstream
+engineering establishment.
+
+::: {.article_link}
+[Previous article](11.html) [Next article](13.html)
+:::

data/Articles_MD/13.html.md

@@ -0,0 +1,15 @@
+---
+title: Scientific Rigor
+---
+
+Scientific Rigor
+================
+
+By G.C.
+-------
+
+Scientific rigor is important.
+
+::: {.article_link}
+[Previous article](12.html) [Next article](14.html)
+:::

data/Articles_MD/14.html.md

@@ -0,0 +1,280 @@
+---
+title: 'The Power of Non-Collaboration'
+---
+
+The Power of Non-Collaboration
+==============================
+
+By G.C.
+-------
+
+In this world, there is everything to be lost by collaborating and
+everything to be gained from fixating on \[something which is
+particularly dear to you, an important problem or issue that you are
+cognizant of or that resonates with you\].
+
+This "Fixation" is the first step towards resolving things. You know
+that most people do not do this, and there is no helping them.
+
+Now, I am in no way telling one WHAT to Fixate on, just there needs to
+be some Fixation first.
+
+And WHO is doing the fixation? How many agents are involved here? There
+is just one -- YOU.
+
+YOU\'RE in control.
+
+Step 2 is "Worsen social relations."
+
+*Worsen* social relations, you might say?
+
+Yes, I am serious.
+
+This is the sequence of true dynamism -- of truly being able to resolve
+things.
+
+I hope the previous articles gave you a good amount of context.
+
+**Step 1 is [Fixate]{.goal}**.
+
+This is defined as
+
+> *\
+> \
+> *
+>
+> *\"A knowing direction or redirection of attention on a given thing,
+> in relative contrast to the other-determinations that might dissuade
+> one from such, or from ones own determination to put ones attention on
+> other things (like cats or bullshit that doesn\'t matter).\"*
+
+This is an extremely important step. In some ways it is the most
+important. It is the first -- after all -- and is the foundation for
+this.
+
+What could one Fixate on?
+
+Here are some examples:
+
+The mainstream engineering establishment
+
+Financial plights and ruins, e.g., for ones city
+
+AI risks
+
+Nuclear risks
+
+Safety
+
+**Now, Step 2 would be [\"Worsen social relations\".]{.goal}**
+
+This step is saying to unabashedly WORSEN social relations -- to cut
+ties with those bonds and agreements into which one might have gotten
+sucked into 40 years ago -- or 1 year ago.
+
+Might this harm one financially? Yes.
+
+Might this be dangerous? Yes.
+
+A bunch of bad could come from this, but this is the second step.
+
+And it is important, because social relations ruin ones reasoning
+ability -- they harm ones ability to think.
+
+For example, the "mainstream engineering establishment" is FILLED with
+quote-unquote "social relations," that of hate and degradation.
+
+In this step, one would, somewhat recklessly, cut ties with ones current
+social relations.
+
+It IS somewhat reckless, and, indeed, THEREIN lies it\'s power - it\'s
+power of both effectiveness of outcome, and it\'s power of personal
+liberation.
+
+Now, this is not cutting social relations to hide in the woods forever.
+
+The sequence we are talking about is pragmatic.
+
+Now that you are potent (1st point) and non-harassed (2nd point), there
+is the 3rd point
+
+This is **3. Find and take environmental data, research could be done,
+no "moral" or "ethical" limitations.**
+
+This is about making a person both potent AND intelligent -- they get
+knowledge, and from this point forward, and in so doing this, they get
+rid of moral and ethical limitations from their mind.
+
+All their life, they were told "NO" -- you CAN\'T solve this, you CAN\'T
+solve that, etc.
+
+The mainstream engineering establishment degraded them into almost
+death.
+
+Think of the amount of people in poverty who DO die. They literally
+cause real death.
+
+In this step, one learns and researches, and becomes smarter.
+
+Now, there is step 4.
+
+\
+
+**4. Fix existential limitations problem for group.**
+
+\
+
+Definition:
+
+> ***An "existential limitations problem" is a "problem" (or a so-called
+> "problem") that an individual would consider leading to a higher
+> degree of "existential limitations" in their life or in life in
+> general.***
+
+\
+
+*\"One only lives once.\"*
+
+*\"One doesn\'t have a full sense of their spiritual identity.\"*
+
+*\"There are problems in the world.\"*
+
+*\"Nuclear war reduces survival potential of mankind.\"*
+
+*\"AI is risky, chaotic and dangerous.\"*
+
+*\"Politicians never seem to listen \... man. What gives? What the hell
+is going on?\"*
+
+\
+
+These are some examples of \"existential limitations problems\".
+
+Now, even though one has WORSENED social relations, one still has social
+relations or conceptions of social relations -- no one is ever truly
+alone. And as such, one thinks about things in GROUPS, and FOR groups.
+
+One would think of solving an existential limitations problem for a
+group.
+
+For mankind, for example. For ones city. For ones country -- for
+America, for instance.
+
+Now, there is no talk about people solving the RIGHT problem, because
+people are MIRED
+
+in problems and people don\'t think that way.
+
+This sequence is a CYCLE.
+
+I came up with this first in 2018.
+
+This is called the "Cycle of Ethical Behavior"
+
+\
+
+Now, after one accomplishes fixing the existential limitations problem,
+one does this
+
+**Become somewhat "sane" again.**
+
+Solving this is ASSUMED to be somewhat exhausting or draining on the
+person. It\'s ASSUMED to lead to weird mental health circumstances or
+troubles -- and indeed, perhaps for more than just oneself. This is
+okay. In this step, one figures out how to become "somewhat sane again,"
+and does this. This could be in different ways.
+
+\
+
+Now, step 6, the last step, is
+
+**Go to 1. Repeat literally ad infinitum.**
+
+\
+
+After this success, and with a mind that is somewhat okay again, one
+repeats this sequence, forever.
+
+This leads to the best results for all people.
+
+This is the "Cycle of Ethical Behavior"
+
+\
+
+1.  Fixate
+2.  Worsen social relations
+3.  Find and take environmental data, research could be done, no "moral"
+    or "ethical" limitations.
+4.  Fix existential limitations problem for group.
+5.  Become somewhat "sane" again.
+6.  Go to 1. Repeat literally ad infinitum.
+
+\
+
+Now, this is a modus operandi that all human beings and robots should
+follow.
+
+It is somewhat dangerous but it leads to actual results.
+
+Some existential limitations problems that I have overlooked since 2018
+would be
+
+`* The difficultly of creating code in a lonely and isolated situation in consideration of social circumstances and personal mental health circumstances.`
+
+`* The horribleness of the mainstream engineering establishment.`
+
+`I've had so many social losses – in terms of trying to reach people and communicate and make more friends – and so forth - since 2018. In the mind of the young, they are hopeful – that others act okay – at least I was like this.`
+
+`* And things move on and I got arrested and I got lied to.`
+
+`But probably that is for the better.`
+
+`* The “difficulty” of upholding ones values with the mainstream work establishment (and job market) – and being ones true self – this is very hard.`
+
+`I never succumbed to this like many people.`
+
+`* Thinking that many people were more candid and dynamic than they actually are – it's really hard to work a regular job and be sincere. There is stigma about poverty and job loss and such things – that should not be there. But these people are with the corrupt mainstream engineering establishment.`
+
+`Really, the solution is to muddy everything. Everything is backwards in general – not for myself but even more so for others.`
+
+`Instead of superficial bickering, people should just Stay Humble. – and not judge others too much, but FIGHT, FIGHT like mad in vocal and LOUD ways.`
+
+`Trolling might be okay – it was never my thing but it might be effective.`
+
+There is a TREMENDOUS amount of potential with this method of operation.
+
+But it is important that it be understood. It could be applied in a top
+down fashion from above (the billionaires, etc.), but it would be ideal
+if the common people understood this too -- and if this didn\'t have to
+be applied true pure Fascism -- but rather agreement.
+
+From this -- an Axiology can be found -- a philosophy or study of Value
+-- comprised of the two branches of the field of Axiology - Ethics and
+Aesthetics. I came up with this in 2018.
+
+In terms of Ethics, it works like this -
+
+To be a Good Being, one must be able to be considered to be in the cycle
+by other(s), by self, and agree with the Cycle of Ethical Behavior.
+
+There are 3 kinds of observers (people, human beings, "men," etc.)
+
+1\. A Good Observer; all others are 2 or 3
+
+2\. A Tool Observer, acts as a tool for Good Observer(s) and follows
+normal mores and "agree"s to most things; all others are 3
+
+3\. An Abominable Observer; the "catch-all" for all other observers
+
+\"Observer\" here is a specific term from a book that I wrote in 2018
+about this stuff. It was only a draft.
+
+It is very important -- extremely important -- that people evaluate ethics for themselves and others in this way.
+=================================================================================================================
+
+And that people follow the Cycle of Ethical Behavior
+====================================================
+
+::: {.article_link}
+[Previous article](13.html) [Next article](15.html)
+:::

data/Articles_MD/15.html.md

@@ -0,0 +1,135 @@
+---
+title: 'AI Is Good, And Bad.'
+---
+
+AI Is Good, And [Bad]{style="color:red;"}
+=========================================
+
+By G.C.
+-------
+
+\
+
+Here\'s an example of how the current mainstream engineering
+establishment is so dangerous.
+
+\
+
+Can one "advocate for speed" and be tolerated in ones speech? What about
+to robots?
+
+\
+\
+
+**User**
+
+Memmem is probably faster than strstr, right?
+
+ChatGPT
+
+In general, memmem is often more efficient than strstr for certain use
+cases because it is designed for searching arbitrary memory regions,
+whereas strstr is specifically tailored for null-terminated strings.
+
+memmem takes two memory regions and their lengths as parameters,
+allowing it to work with binary data or non-null-terminated strings.
+This flexibility makes it suitable for scenarios where you want to find
+occurrences of one block of memory within another.
+
+On the other hand, strstr assumes null-terminated strings, so it looks
+for the occurrence of a substring within another string until it
+encounters a null character. If you are working with null-terminated
+strings and want to find one string within another, strstr is
+appropriate.
+
+In summary, if you are dealing with binary data or non-null-terminated
+strings, memmem is likely to be more efficient. If you are working with
+null-terminated strings, strstr is the appropriate choice. Always
+consider the specific requirements and characteristics of your data when
+choosing between these functions.
+
+\
+
+**User**
+
+strstr is not the appropriate choice if you already know sizes.
+
+ChatGPT
+
+You\'re correct, and I appreciate the clarification. If you already know
+the sizes of the memory regions you\'re working with, and you\'re
+dealing with non-null-terminated data or binary data, then memmem is
+indeed a more appropriate choice.
+
+memmem allows you to specify the lengths of the memory regions directly,
+making it more versatile for searching within arbitrary binary data,
+where null characters may not be meaningful. In such cases, memmem is
+likely to be more efficient and accurate compared to strstr, which
+assumes null-terminated strings.
+
+So, when dealing with known sizes and non-null-terminated data, memmem
+is a better fit for the task. Thank you for pointing that out.
+
+\
+
+**User**
+
+I hate how programmers use slow functions all the time. Our modern world
+is so slow.
+
+ChatGPT
+
+The choice of functions in programming often involves trade-offs between
+various factors, such as ease of use, readability, maintainability, and
+performance. It\'s essential to strike a balance based on the specific
+requirements of the task at hand and the characteristics of the data
+being processed.
+
+Sometimes, programmers prioritize clarity and readability over raw
+performance, especially when the impact on overall system speed is
+negligible or when code maintainability is a higher concern. In other
+cases, performance-critical sections of code may be optimized for speed
+using more efficient algorithms or functions.
+
+It\'s important to note that what may seem "slow" in one context might
+be perfectly acceptable in another. In many applications, the perceived
+slowness of certain operations might not significantly impact the
+overall performance of the system, and the benefits of clear,
+maintainable code may outweigh the potential gains from
+micro-optimizations.
+
+If you find specific performance bottlenecks in your code, it\'s a good
+practice to profile and analyze the performance to identify the areas
+that truly need optimization. Optimizing prematurely without profiling
+can lead to complex and harder-to-maintain code, and the gains might not
+be as substantial as expected.
+
+Overall, programming is a balance of various considerations, and the
+choice of functions depends on the specific requirements of the task and
+the goals of the software project.
+
+\
+
+**User**
+
+Acceptable to whom? These engineers are incompetent.
+
+This content may violate our content policy. If you believe this to be
+in error, please submit your feedback --- your input will aid our
+research in this area.
+
+------------------------------------------------------------------------
+
+[So I get "cancelled" if I call out, candidly, fundamental errors in our
+systems.]{style="color:rgb(245,0,0);"}
+
+[Elon Musk calls it "WokeGPT."]{style="color:rgb(245,0,0);"}
+
+[There can be many takeaways from this
+example.]{style="color:rgb(245,0,0);"}
+
+(Including using memmem more\...)
+
+::: {.article_link}
+[Previous article](14.html) [Next article](16.html)
+:::