Document not found (404)
-This URL is invalid, sorry. Please use the navigation bar or search to continue.
- -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/highlight.css b/docs/highlight.css
deleted file mode 100644
index ba57b82..0000000
--- a/docs/highlight.css
+++ /dev/null
@@ -1,82 +0,0 @@
-/*
- * An increased contrast highlighting scheme loosely based on the
- * "Base16 Atelier Dune Light" theme by Bram de Haan
- * (http://atelierbram.github.io/syntax-highlighting/atelier-schemes/dune)
- * Original Base16 color scheme by Chris Kempson
- * (https://github.com/chriskempson/base16)
- */
-
-/* Comment */
-.hljs-comment,
-.hljs-quote {
- color: #575757;
-}
-
-/* Red */
-.hljs-variable,
-.hljs-template-variable,
-.hljs-attribute,
-.hljs-tag,
-.hljs-name,
-.hljs-regexp,
-.hljs-link,
-.hljs-name,
-.hljs-selector-id,
-.hljs-selector-class {
- color: #d70025;
-}
-
-/* Orange */
-.hljs-number,
-.hljs-meta,
-.hljs-built_in,
-.hljs-builtin-name,
-.hljs-literal,
-.hljs-type,
-.hljs-params {
- color: #b21e00;
-}
-
-/* Green */
-.hljs-string,
-.hljs-symbol,
-.hljs-bullet {
- color: #008200;
-}
-
-/* Blue */
-.hljs-title,
-.hljs-section {
- color: #0030f2;
-}
-
-/* Purple */
-.hljs-keyword,
-.hljs-selector-tag {
- color: #9d00ec;
-}
-
-.hljs {
- display: block;
- overflow-x: auto;
- background: #f6f7f6;
- color: #000;
-}
-
-.hljs-emphasis {
- font-style: italic;
-}
-
-.hljs-strong {
- font-weight: bold;
-}
-
-.hljs-addition {
- color: #22863a;
- background-color: #f0fff4;
-}
-
-.hljs-deletion {
- color: #b31d28;
- background-color: #ffeef0;
-}
diff --git a/docs/highlight.js b/docs/highlight.js
deleted file mode 100644
index 18d2434..0000000
--- a/docs/highlight.js
+++ /dev/null
@@ -1,54 +0,0 @@
-/*
- Highlight.js 10.1.1 (93fd0d73)
- License: BSD-3-Clause
- Copyright (c) 2006-2020, Ivan Sagalaev
-*/
-var hljs=function(){"use strict";function e(n){Object.freeze(n);var t="function"==typeof n;return Object.getOwnPropertyNames(n).forEach((function(r){!Object.hasOwnProperty.call(n,r)||null===n[r]||"object"!=typeof n[r]&&"function"!=typeof n[r]||t&&("caller"===r||"callee"===r||"arguments"===r)||Object.isFrozen(n[r])||e(n[r])})),n}class n{constructor(e){void 0===e.data&&(e.data={}),this.data=e.data}ignoreMatch(){this.ignore=!0}}function t(e){return e.replace(/&/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'")}function r(e,...n){var t={};for(const n in e)t[n]=e[n];return n.forEach((function(e){for(const n in e)t[n]=e[n]})),t}function a(e){return e.nodeName.toLowerCase()}var i=Object.freeze({__proto__:null,escapeHTML:t,inherit:r,nodeStream:function(e){var n=[];return function e(t,r){for(var i=t.firstChild;i;i=i.nextSibling)3===i.nodeType?r+=i.nodeValue.length:1===i.nodeType&&(n.push({event:"start",offset:r,node:i}),r=e(i,r),a(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:r,node:i}));return r}(e,0),n},mergeStreams:function(e,n,r){var i=0,s="",o=[];function l(){return e.length&&n.length?e[0].offset!==n[0].offset?e[0].offset
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Getting Started
-
"C3 is a programming language that builds on the syntax and semantics of the C language, with the goal of evolving it while still retaining familiarity for C programmers."
-About this book
---This book is being written with 0.6.x in mind. It may include nightly releases that have fixed problems with 0.6.2. -If an example doesn't quite work with 0.6.2, try using the latest compiler.
-
This was inspired by the Zig Cookbook which displays common and more idiomatic ways to use Zig around certain problems. I wanted to create a community driven book, that would do the same for C3. I believe it is something that can help developers pickup C3, as it provides another source to browse.
-I have used new languages where documentation and community driven media was scarce, which made it very hard to get an understanding of the language in a more practical manner. Hopefully this book can help with this issue and get some more people into C3.
-Since I'm writing this as a newbie to C3, there are bound to be issues or better ways to achieve things.
-Contributing to the book
--
-
- Found a typo or an example does not work? Create an issue here -
- Want to add more examples? Create a fork -
Installing C3
-Use one of the following sources to download or build the C3 compiler from source:
--
-
- Website -
- Github Release -
- More options on their Github page, to build from source or use an OS repository -
Editors / Tooling
-There is a work in progress LSP that can be found here.
--
-
- VSCode extension can be installed through the extension tab -
- VIM / Emacs / Sublime / Zed / ... are located in a single repository -
":e:f.tabReplace?e.replace(/\t/g,f.tabReplace):e):e}function E(e){let n=null;const t=function(e){var n=e.className+" ";n+=e.parentNode?e.parentNode.className:"";const t=f.languageDetectRe.exec(n);if(t){var r=T(t[1]);return r||(console.warn(g.replace("{}",t[1])),console.warn("Falling back to no-highlight mode for this block.",e)),r?t[1]:"no-highlight"}return n.split(/\s+/).find(e=>p(e)||T(e))}(e);if(p(t))return;S("before:highlightBlock",{block:e,language:t}),f.useBR?(n=document.createElement("div")).innerHTML=e.innerHTML.replace(/\n/g,"").replace(/
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/mark.min.js b/docs/mark.min.js
deleted file mode 100644
index 1636231..0000000
--- a/docs/mark.min.js
+++ /dev/null
@@ -1,7 +0,0 @@
-/*!***************************************************
-* mark.js v8.11.1
-* https://markjs.io/
-* Copyright (c) 2014–2018, Julian Kühnel
-* Released under the MIT license https://git.io/vwTVl
-*****************************************************/
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?module.exports=t():"function"==typeof define&&define.amd?define(t):e.Mark=t()}(this,function(){"use strict";var e="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e},t=function(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")},n=function(){function e(e,t){for(var n=0;n
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Getting Started
-"C3 is a programming language that builds on the syntax and semantics of the C language, with the goal of evolving it while still retaining familiarity for C programmers."
-About this book
---This book is being written with 0.6.x in mind. It may include nightly releases that have fixed problems with 0.6.2. -If an example doesn't quite work with 0.6.2, try using the latest compiler.
-
This was inspired by the Zig Cookbook which displays common and more idiomatic ways to use Zig around certain problems. I wanted to create a community driven book, that would do the same for C3. I believe it is something that can help developers pickup C3, as it provides another source to browse.
-I have used new languages where documentation and community driven media was scarce, which made it very hard to get an understanding of the language in a more practical manner. Hopefully this book can help with this issue and get some more people into C3.
-Since I'm writing this as a newbie to C3, there are bound to be issues or better ways to achieve things.
-Contributing to the book
--
-
- Found a typo or an example does not work? Create an issue here -
- Want to add more examples? Create a fork -
Installing C3
-Use one of the following sources to download or build the C3 compiler from source:
--
-
- Website -
- Github Release -
- More options on their Github page, to build from source or use an OS repository -
Editors / Tooling
-There is a work in progress LSP that can be found here.
--
-
- VSCode extension can be installed through the extension tab -
- VIM / Emacs / Sublime / Zed / ... are located in a single repository -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/docs/searcher.js b/docs/searcher.js
deleted file mode 100644
index dc03e0a..0000000
--- a/docs/searcher.js
+++ /dev/null
@@ -1,483 +0,0 @@
-"use strict";
-window.search = window.search || {};
-(function search(search) {
- // Search functionality
- //
- // You can use !hasFocus() to prevent keyhandling in your key
- // event handlers while the user is typing their search.
-
- if (!Mark || !elasticlunr) {
- return;
- }
-
- //IE 11 Compatibility from https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/startsWith
- if (!String.prototype.startsWith) {
- String.prototype.startsWith = function(search, pos) {
- return this.substr(!pos || pos < 0 ? 0 : +pos, search.length) === search;
- };
- }
-
- var search_wrap = document.getElementById('search-wrapper'),
- searchbar = document.getElementById('searchbar'),
- searchbar_outer = document.getElementById('searchbar-outer'),
- searchresults = document.getElementById('searchresults'),
- searchresults_outer = document.getElementById('searchresults-outer'),
- searchresults_header = document.getElementById('searchresults-header'),
- searchicon = document.getElementById('search-toggle'),
- content = document.getElementById('content'),
-
- searchindex = null,
- doc_urls = [],
- results_options = {
- teaser_word_count: 30,
- limit_results: 30,
- },
- search_options = {
- bool: "AND",
- expand: true,
- fields: {
- title: {boost: 1},
- body: {boost: 1},
- breadcrumbs: {boost: 0}
- }
- },
- mark_exclude = [],
- marker = new Mark(content),
- current_searchterm = "",
- URL_SEARCH_PARAM = 'search',
- URL_MARK_PARAM = 'highlight',
- teaser_count = 0,
-
- SEARCH_HOTKEY_KEYCODE = 83,
- ESCAPE_KEYCODE = 27,
- DOWN_KEYCODE = 40,
- UP_KEYCODE = 38,
- SELECT_KEYCODE = 13;
-
- function hasFocus() {
- return searchbar === document.activeElement;
- }
-
- function removeChildren(elem) {
- while (elem.firstChild) {
- elem.removeChild(elem.firstChild);
- }
- }
-
- // Helper to parse a url into its building blocks.
- function parseURL(url) {
- var a = document.createElement('a');
- a.href = url;
- return {
- source: url,
- protocol: a.protocol.replace(':',''),
- host: a.hostname,
- port: a.port,
- params: (function(){
- var ret = {};
- var seg = a.search.replace(/^\?/,'').split('&');
- var len = seg.length, i = 0, s;
- for (;i
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Getting Started
-"C3 is a programming language that builds on the syntax and semantics of the C language, with the goal of evolving it while still retaining familiarity for C programmers."
-About this book
---This book is being written with 0.6.x in mind. It may include nightly releases that have fixed problems with 0.6.2. -If an example doesn't quite work with 0.6.2, try using the latest compiler.
-
This was inspired by the Zig Cookbook which displays common and more idiomatic ways to use Zig around certain problems. I wanted to create a community driven book, that would do the same for C3. I believe it is something that can help developers pickup C3, as it provides another source to browse.
-I have used new languages where documentation and community driven media was scarce, which made it very hard to get an understanding of the language in a more practical manner. Hopefully this book can help with this issue and get some more people into C3.
-Since I'm writing this as a newbie to C3, there are bound to be issues or better ways to achieve things.
-Contributing to the book
--
-
- Found a typo or an example does not work? Create an issue here -
- Want to add more examples? Create a fork -
Installing C3
-Use one of the following sources to download or build the C3 compiler from source:
--
-
- Website -
- Github Release -
- More options on their Github page, to build from source or use an OS repository -
Editors / Tooling
-There is a work in progress LSP that can be found here.
--
-
- VSCode extension can be installed through the extension tab -
- VIM / Emacs / Sublime / Zed / ... are located in a single repository -
Hello World!
-Let's write the classic example, Hello World! But before that, we have two options with how to proceed:
- -Using a project
-Creating a project is quite simple in C3. We can use the c3c executable to initialise, build and run our project.
Let's create a new project:
-$ c3c init myproject
-$ cd myproject
-We now have a new project directory and this would have created a few directories within it, a license, a project.json and a readme. This includes the build directory, which is where your project will be compiled into. In C3 we use the src directory and this is where you will find the main.c3 file. You can see more details about project structure in the C3 guide.
Let's open the main file src/main.c3 in your editor and write this code:
module myproject;
-import std::io;
-
-fn void main() {
- io::printn("Hello, World!");
-}
-We can now run this code with:
-$ c3c run
-This should then print to the console
-Program linked to executable 'myproject'.
-Launching ./myproject
-Hello, World!
-Program completed with exit code 0.
-Running directly
-We can create a new file with the .c3 extension. Then we can write this code:
module myproject;
-import std::io;
-
-fn void main() {
- io::printn("Hello, World!");
-}
-We will use the compiler to build, run and then dispose of the executable:
-$ c3c compile-run --run-once main.c3
-This should then print to the console
-Program linked to executable 'myproject'.
-Launching ./myproject
-Hello, World!
-Program completed with exit code 0.
-You can also just compile the file and run the executable directly:
-$ c3c compile main.c3 -o hello
-$ ./hello
-
-Hello, World!
-Explaining our program
-You have now written your first C3 program. Let's break down what is happening in our code. We can start with the first line:
-module myproject;
-Every file must start with a module name. We can think of a module like a namespace, as each file that has the same module name is considered the same module. Module names are not tied to files or the directory they are in, so it is up to you to name them correctly. To avoid clashing, we must use longer and/or more detailed names. This could be something like projectname::foo::bar::baz.
import std::io;
-Next is our import. This is how we import modules in C3. One thing that might confuse people who might be used to namespaces, is that this is actually a sub-namespace/module within std. However, as described above, this is just a name. You cannot create sub-modules as you might expect from other languages, but this is just a naming style to keep things organised logically.
fn void main() {
- io::printn("Hello, World!");
-}
-Functions in C3 use the fn keyword to denote a function declaration. It is then followed by the return type (void) and then a function name and its parameters. This should look pretty familiar for anyone who's used a C-style language. The interesting thing here is our io::printn. If you tried to remove the io:: prefix, you will see this error:
Error: Functions from other modules must be prefixed with the module name.
-Any function that comes from a different module, must be prefixed with its module name. This helps the reader also understand where this function comes from. We will see this often later, when it comes to types as well.
---There is another way we can write this function. This will be familiar for those who have used JavaScript:
--fn void main() => io::printn("Hello, World!"); -It is possible to write a single expression function, using the
-=>arrow syntax. > This is useful for writing simple functions that return a value.
This was probably quite a long explanation of Hello World, but this is essentially how this book should be structured. We will write an example, then give an explanation on the hows and why. Hopefully this can help give better understanding of the code written and leaves you both curious for more and with questions answered.
- -