a side-by-side reference sheet
grammar and invocation | variables and expressions | arithmetic and logic | strings | regexes | dates and time | fixed-length-arrays | resizable arrays | dictionaries | functions | execution control | concurrency | file handles | files | file formats | directories | processes and environment | option parsing | libraries and namespaces | objects | user-defined types | c preprocessor macros | net and web | unit tests | debugging and profiling
| version | |||
|---|---|---|---|
| c | go | java | |
| version used |
C11, gcc 4.8, clang 3.5 | 1.10 | java 1.7 |
| show version |
$ gcc --version | $ go version | $ javac -version |
| implicit prologue | #include <errno.h> #include <stdlib.h> #include <stdio.h> #include <string.h> #include <time.h> #include <wchar.h> |
import "fmt" | none |
| grammar and invocation | |||
| c | go | java | |
| hello world | $ cat hello.c #include <stdio.h> int main(int argc, char **argv) { printf("Hello, World!\n"); } $ gcc hello.c $ ./a.out Hello, World! |
$ cat hello.go package main import "fmt" func main() { fmt.Printf("Hello, World!\n") } $ go build hello.go $ ./hello Hello, World! |
$ cat Hello.java public class Hello { public static void main(String[] args) { System.out.println("Hello, World!"); } } $ javac Hello.java $ java Hello |
| file suffixes source, header, object file |
.c .h .o | .go none none | Foo.java none Foo.class Foo.java must define a single top level class Foo |
| statement terminator | ; | ; or sometimes newline a new line terminates a statement when the last token on the line is (1) an identifier, (2) a numeric, character, or string literal, (3) one of the keywords break, continue, fallthrough, or return, (4) one of ++, --, ), ], or } |
; |
| top level statements | each file contains the following elements in order: (1) optional package directive (2) zero or more import directives (3) one public class definition and zero or more private class definitions |
||
| block delimiters |
{ … } | { … } | { } |
| end-of-line comment |
// comment | // comment | // comment |
| multiple line comment | /* comment line another line */ |
/* comment line another line */ |
/* comment another comment */ |
| variables and expressions | |||
| c | go | java | |
| variable | /* if inside function, memory allocated on stack: */ int i; int j = 3; /* memory allocated on heap: */ int *ptr = malloc(sizeof *ptr); /* if malloc fails, it returns NULL and sets errno to ENOMEM */ *ptr = 7; |
// memory allocated on stack: var i int // allocated on stack; type inferred from literal: j := 3 // memory allocated on heap: ptr := new(int) *ptr = 7 |
int i; int j = 3; |
| free heap |
free(ptr); | none; uses garbage collection | garbage collected |
| global variable | /* in foo.c, outside of any function: */ int x = 7; /* to declare in bar.c: */ extern int x; |
// foo.go: package foo // capitalized top-level identifiers are exported: var X = 7 // bar.go: package bar import foo // package scope: var y = 3 func baz() { // local scope: var z = 5 fmt.Println(foo.X + y + z) } |
foo/Foo.java: package foo; // globals must be declared inside a // class: public class Foo { public static int bar; } UseFoo.java: import foo.Foo; public class UseFoo { public static void main(String[] args) { System.out.println(Foo.bar); } } |
| uninitialized variable | The behavior of reading from uninitialized stack variables or unitialized memory allocated by malloc is undefined. Global and static variables are zero-initialized. Heap variables allocated by calloc have their bytes zeroed. |
Every type has a zero value. For numeric types it is zero and for strings it is the empty string. | Compilation error if local variables are not explicitly initialized. Global variables and object attributes will be zero-initialized if not explicitly initialized. Zero values are zero for numeric types, false for booleans, and null for reference types. |
| compile time constant | /* usually preprocessor is used: */ #define PI 3.14 |
const Pi = 3.14 | final double pi = 3.14; |
| immutable variable |
const int i = rand(); | none | import java.util.Random; Random rnd = new Random(); final int i = rnd.nextInt(100); |
| assignment | i = 3; | // defines variable of appropriate type: i := 3 // variable must already be declared: i = 3 |
int n; n = 3; |
| parallel assignment | none | // define variables of appropriate type: m, n := 3, 7 // x and y must already be declared: x, y = 2, 8 |
none |
| swap | int x = 1, y = 2, tmp; tmp = x; x = y; y = tmp; |
x, y = y, x | int x = 1, y = 2, tmp = 0; tmp = x; x = y; y = tmp; |
| compound assignment | arithmetic: += -= *= /= %= bit: <<= >>= &= |= ^= |
arithmetic: += -= *= /= %= bit: <<= >>= &= |= ^= |
+= -= *= /= %= <<= >>= &= ^= |= >>= is arithmetic right shift, >>>= is logical right shift |
| increment and decrement | premodifiers: ++i --i postmodifiers: i++ i-- |
postmodifiers only; cannot be used in expressions: i++ i-- |
int n = 1; int one = n++; int three = ++n; int two = --n; |
| address | int i = 3; int* ptr = &i; |
i := 3 var ptr *int ptr = &i ptr2 := &i |
none |
| dereference |
int i2 = *ptr; | i2 := *ptr | none |
| type size | /* put type inside parens: */ sizeof (int) /* expressions and values don't require parens: */ sizeof 1 + 1 |
import "unsafe" // use expression or name of variable with type: unsafe.Sizeof(i) unsafe.Sizeof(1 + 1) |
none |
| address arithmetic | int a[] = {3, 2, 1, 0}; for (int *p = a; *p; ++p) { printf("%d\n", *p); } |
none | none |
| null |
/* pointer types only: */ NULL |
// cannot be stored in numeric or string variable: nil |
null |
| null test |
ptr == NULL | ptr == nil | ref == null |
| conditional expression |
x > 0 ? x : -x | none | x > 0 ? x : -x |
| arithmetic and logic | |||
| c | go | java | |
| boolean type |
int /* includes type for consistency with C++: */ #include <stdbool.h> bool |
bool | boolean |
| true and false |
1 0 /* includes identifiers for consistency with C++: */ #include <stdbool.h> true false |
true false | true false |
| falsehoods |
0 0.0 NULL false | false | false |
| logical operators |
&& || ! | && || ! | && || ! |
| relational operators |
== != < > <= >= | == != < > <= >= | == != < > <= >= |
| integer type | signed char 1+ bytes short int 2+ bytes int 2+ bytes long int 4+ bytes long long int 4+ bytes types with portable sizes are defined in stdint.h: int8_t int16_t int32_t int64_t |
int int8 int16 int32 int64 |
byte n1; // 1 byte short n2; // 2 bytes int n3; // 4 bytes long n4; // 8 bytes |
| unsigned type | unsigned char: 1+ bytes unsigned short int 2 bytes+ unsigned int 2 bytes+ unsigned long int 4+ bytes unsigned long long int 4+ bytes types with portable sizes are defined in stdint.h: uint8_t uint16_t uint32_t uint64_t |
uint8 (byte) uint16 uint32 uint64 |
char n1; //2 bytes |
| float type | float 4 bytes double 8 bytes long double 16 bytes registers may be larger on some systems |
float32 float64 |
float x1; // 4 bytes double x2; // 8 bytes |
| arithmetic operators |
+ - * / % | + - * / % | + - * / % |
| integer division |
3 / 7 | 3 / 7 | // evaluates to 2: 7 / 3 |
| integer division by zero |
system dependent; process often sent a SIGFPE signal | on Unix, process sent a SIGFPE signal | throws java.lang.ArithmeticException |
| float division |
3 / (float)7 | 3 / float32(7) | 7 / (float)3 |
| float division by zero | /* these are float values but not literals: */ inf, nan, or -inf |
// these are float values but not literals: +Inf, NaN, or -Inf // to get the float values: import "math" math.Inf(1) math.Nan() math.Inf(-1) |
Float.POSITIVE_INFINITY Float.NaN Float.NEGATIVE_INFINITY constants with same names defined in Double |
| power | #include <math.h> pow(2.0, 3.0) |
import "math" math.Pow(2.0, 3.0) |
Math.pow(2.0, 32.0); |
| sqrt | #include <math.h> sqrt(2); |
include "math" math.Sqrt(2) |
Math.sqrt(2) |
| sqrt -1 | #include <math.h> /* nan */ double x = sqrt(-1.0); |
import "math" // NaN x := math.Sqrt(-2.0) import "math/cmplx" // (0+1.41421356i) z := cmplx.Sqrt(-2.0) |
Double.NaN |
| transcendental functions | #include <math.h> exp log log2 log10 sin cos tan asin acos atan atan2 |
include "math" math.Exp math.Log math.Log2 math.Log10 math.Sin math.Cos math.Tan math.Asin math.Acos math.Atan math.Atan2 |
Math.exp Math.log none Math.log10 Math.sin Math.cos Math.tan Math.asin Math.acos Math.atan Math.atan2 |
| transcendental constants | #include <math.h> M_PI M_E |
import "math" math.Pi Math.E |
Math.E Math.PI |
| float truncation | #include <math.h> double d = 3.77; long trunc = (long)d; long rnd = round(d); long flr = floorl(d); long cl = ceill(d); |
include "math" x = 3.77 trunc := int(x) none flr := int(math.Floor(x)) cl := int(math.Ceil(x)) |
(long)3.77 Math.round(3.77) (long)Math.floor(3.77) (long)Math.ceil(3.77) |
| absolute value | #include <math.h> /* fabs() */ int i = abs(-7); float x = fabs(-7.77); |
include "math" none math.Abs(-7.77) |
Math.abs(-7) Math.abs(-7.77) |
| integer overflow | modular arithmetic | ||
| float overflow | Float.POSITIVE_INFINITY | ||
| float limits largest finite float, smallest positive float |
Float.MAX_VALUE Float.MIN_VALUE Double.MAX_VALUE Double.MIN_VALUE |
||
| complex type | float complex 8 bytes double complex 16 bytes long double complex 32 bytes |
complex64 complex128 |
none |
| complex construction | #include <complex.h> double complex z; z = 1.0 + 2.0 * I; /* C11: */ double complex z = CMPLX(1.0, 2.0); |
var z complex128 = 1.0 + 2.0i | none |
| complex decomposition real and imaginary component, argument, absolute value, conjugate |
#include <complex.h> double x; double complex w; x = creal(z); x = cimag(z); x = carg(z); x = cabs(z); w = conj(z); |
import "math/cmplx" var x float64 var w complex128 x = real(z) x = imag(z) x = cmplx.Phase(z) x = cmplx.Abs(z) w = cmplx.Conj(z) |
none |
| random number uniform integer, uniform float |
/* lrand48 returns value in [0, 2**31 - 1]: */ long n = lrand48(() % 100; /* Value in interval [0.0, 1.0): */ double x = drand48(); |
import "math/rand" n := rand.Intn(100) x := rand.Float64() |
import java.util.Random; Random rnd = new Random(); int i = rnd.nextInt(100); double x = rnd.nextDouble(); double y = rnd.nextGaussian(); |
| random seed | srand48(17); | import "math/rand" rand.Seed(17) |
import java.util.Random; Random rnd = new Random(); rnd.setSeed(17); // seed can also be passed to constructor |
| bit operators |
<< >> & | ^ ~ | << >> & | none ^ | << >> & | ^ ~ >> is arithmetic right shift, >>> is logical right shift |
| binary, octal, and hex literals | none 052 0x2a |
none 052 0x2a |
0b101010 052 0x2a |
| radix convert integer to and from string with radix |
Integer.toString(42, 7) Integer.parseInt("60", 7) |
||
| strings | |||
| c | go | java | |
| string type |
char * wchar_t * wchar_t is typically 32 bits on Linux and 16 bits on Windows. |
// immutable: string // mutable: []byte |
// immutable: java.lang.String // mutable: java.lang.StringBuffer // StringBuffer has append(), delete(), // deleteCharAt(), insert(), replace(), setCharAt(). |
| string literal |
/* string in initialized data segment: */ char *s = "hello"; wchar_t *ws = L"hello"; /* string in heap: */ char *s2 = strdup(s); wchar_t *ws2 = wcsdup(ws); /* if strdup cannot allocate memory, it returns NULL and sets errno to ENOMEM. */ |
"hello" // raw string literal: `hello` // convert literal to mutable string: []byte("hello") |
"don't say\"no\"" |
| newline in string literal | /* compiler concatenates literals separated by whitespace: */ char *s = "first line\n" "second line"; |
// backquote literals only: let s := `first line second line` |
none |
| string escapes | \a \b \f \n \r \t \v \" \' \? \\ \o \oo \ooo \xhh \uhhhh \Uhhhhhhhh |
Double quote literals only: \a \b \f \n \r \t \v \\ \" \ooo \xhh \uhhhh \Uhhhhhhhh |
\b \f \n \r \t \\ \" \' \uhhhh \o \oo \ooo |
| compare strings | /* == and < compare memory addresses: */ strcmp("hello", "world") == 0 strcmp("hello", "world") < 0 wcscmp(L"hello", L"world") == 0 wcscmp(L"hello", L"world") < 0 |
"hello" == "world" "hello" < "world" |
"hello".compareTo("world") |
| string to number | /* conversion functions: strtol strtoll strtoul strtoull strtof strtod strtold */ #include <limits.h> char *s = "101 dalmations"; char *rest; long n = strtol(s, &rest, 10); if (n == 0 && errno == EINVAL) printf("invalid input\n"); else if ((n == LONG_MAX || n == LONG_MIN) && errno == ERANGE) printf("overflow\n"); else printf("%ld %s\n", n, rest); /* wide string conversion functions: wcstol wcstoll wcstoul wcstoull wcstof wcstod wcstold */ |
import "strconv" //2nd arg is base, 3rd arg is size of int in bits: i, _ := strconv.ParseInt("17", 10, 32) // 2nd arg is size of float in bits: x, _ := strconv.ParseFloat("3.14", 32) |
Byte.parseByte("14") Short.parseShort("14") Integer.parseInt("14") Long.parseLong("14") Float.parseFloat("14.7") Double.parseDouble("14.7") |
| number to string | long n = 1234; char buf[100]; snprintf(buf, 100, "%ld", n); wchar_t buf2[100]; swprintf(buf2, 100, L"%ld", n); /* some format specifiers: %d %ld %lld %u %lu %llu %.3f %.3e */ |
import "strconv" // 3rd arg is precision after decimal point; // 4th arg is size of float in bits: strconv.FormatFloat(3.14, 'f', 4, 32) // 2nd arg is base: strconv.FormatInt(7, 10) |
Integer.toString(14) Long.toString(14) Double.toString(14.7) |
| split | /* strtok_r modifies 1st arg */ char *s = strdup("foo,bar baz"); char *sep = " ,"; char *tok, *last; /* tok is never an empty string: */ for (tok = strtok_r(s, sep, &last); tok; tok = strtok_r(NULL, sep, &last)) printf("token: %s\n", tok); /* also wcstok */ |
import "strings" s := "foo bar baz" parts := strings.Split(s, " ") |
"Bob Ned Amy".split(" ") |
| join |
none | import "strings" parts := []string{"foo", "bar", "baz"} s := strings.Join(parts, " ") |
String[] a = {"foo", "bar", "baz"}; String s = String.join(" ", a); |
| concatenate | char *s1 = "hello"; char *s2 = " world"; size_t len = strlen(s1) + strlen(s2) + 1; char *s3 = (char *)calloc(len, sizeof *s3); strcpy(s3, s1); strcat(s3, s2); /* also wcscpy and wcscat */ |
"hello" + " world" | "hello" + " world" |
| replicate | none | import "strings" hbar := strings.Repeat("-", 80) |
import java.util.Arrays; char[] a = new char[80]; Arrays.fill(a, '-'); String s = new String(a); |
| extract substring | char target[3]; char *source = "hello"; strncpy(target, source + 2, 2); target[2] = '\0'; /* also wcsncpy */ |
"hello"[2:4] | "hello".substring(2,4) |
| index of substring | const char *s = "hello"; const char *p = strstr("hello", "ll"); size_t idx = p ? p - s : -1; /* also wcsstr */ |
import "strings" // zero-based index; -1 if not found: strings.Index("hello", "ll") |
"hello".indexOf("ll") |
| format string | char buf[100]; snprintf(buf, 100, "%s: %d", "Spain", 7); wchar_t buf2[100]; swprintf(buf2, 100, L"%S: %d", L"Spain", 7); |
buf := fmt.Sprintf("%s: %d", "Spain", 7) | String.format("%s: %d", "Spain", 7) |
| translate case to upper, to lower |
char *s = strdup("hello"); int i; for (i=0; i < strlen(s); ++i) s[i] = toupper(s[i]); for (i=0; i < strlen(s); i++) s[i] = tolower(s[i]); /* also towupper and towlower */ |
import "strings" strings.ToUpper("hello") strings.ToLower("HELLO") |
"hello".toUpperCase() "HELLO".toLowerCase() |
| trim both sides, on left, on right |
char *s = strdup(" lorem "); size_t i, j; /* trim left */ for (i = 0; s[i] && isspace(s[i]); ++i); if (i) for (size_t j = 0; j < strlen(s) - i + 1; ++j) s[j] = s[j + i]; /* trim right */ for (i = strlen(s) - 1; s[i] && isspace(s[i]); i); s[i + 1] = '\0'; /* also iswspace */ |
import "strings" s := " lorem " strings.Trim(s, " ") strings.TrimLeft(s, " ") strings.TrimRight(s, " ") |
" hello ".trim() |
| pad | char buf[100]; /* pad right: */ snprintf(buf, 100, "%-10s", "hello"); /* pad left: */ snprintf(buf, 100, "%10s", "hello"); /* also swprintf */ |
right_pad := fmt.Sprintf("%-10s\n", "hello") left_pad := fmt.Sprintf("%10s\n", "hello") |
|
| length |
strlen("hello") wcslen(L"hello") |
s := "αλφα" char_length := 0 // iterate over characters, setting i to index and rune_val // to Unicode point. Bad bytes get code point 0xFFFD: for i, rune_val := range s { fmt.Printf("%d %d\n", i, rune_val) char_length += 1 } fmt.Printf("bytes: %d chars: %d\n", len(s), char_length) |
String s = "hello"; int i = s.length(); |
| character type | char wchar_t |
byte rune |
char Character |
| character literal | 'A' L'A' |
none | char n = 'X'; |
| character lookup | "lorem ipsum"[6] L"lorem ipsum"[6] |
// 7th byte: "lorem ipsum"[6] // 7th char: s := "αλφα βητα" var ch rune for i, rune_val := range s { if i == 6 { ch = rune_val } } |
|
| character index | char *s = "aaa bbb ccc"; char *p; size_t n; p = strchr(s, ' '); if (p) printf("first space at %ld\n", p - s); p = strrchr(s, ' '); if (p) printf("last space at %ld\n", p - s); n = strspn(s, "abc"); printf("first %ld chars in set\n", n); p = strpbrk(s, " ,:."); printf("first %ld chars not in set\n", n); /* also: wcschr wcsrchr wcsspn wcspbrk */ |
||
| character tests | #include <ctype.h> #include <wctype.h> isascii(ch) isrune(ch) iscntrl(ch) isgraph(ch) isalpha(ch) isspace(ch) isupper(ch) islower(ch) isalnum(ch) isdigit(ch) isxdigit(ch) ispunct(ch) /* also: iswascii, iswrune, ... */ |
import "unicode" unicode.IsControl(ch) unicode.IsGraphic(ch) unicode.IsLetter(ch) unicode.IsSpace(ch) unicode.IsUpper(ch) unicode.IsLower(ch) unicode.IsDigit(ch) unicode.IsPunct(ch) |
|
| chr and ord | /* Character types are integer types so no conversion is necessary. Use %c and %C to print a character like a string of length one. */ char ch = 'A'; wchar_t ch2 = L'A'; int i = ch + 7; int i2 = ch2 + 7; wprintf(L"%c %d %C %d\n", ch, ch, ch2, ch2); |
/* Character types are integer types so no conversion is necessary. Use %c to print a character like a string of length one. */ fmt.Printf("lambda: %c\n", 0x3bb) |
|
| regular expressions | |||
| c | go | java | |
| metacharacters | /* REG_BASIC: */ . [ ] \ * ^ $ /* REG_EXTENDED: */ . [ ] \ ( ) * + ? { } | ^ $ |
. [ ] \ ( ) * + ? { } | ^ $ use raw string (i.e. backtick) literals to avoid having to escape backslashes. |
|
| character class abbrevations | /* matches any character; does not match newline if REG_NEWLINE is used: */ . /* more character classes available in pcre library */ |
. \d \D \s \S \w \W | |
| anchors | /* match beginning and end of string; match beginning and end of line if REG_NEWLINE is used: */ ^ $ |
^ $ \A \b \B \z | |
| match test | #include <regex.h> regex_t rx; int retval; char *pat = "1999"; char *s = "It's 1999"; /* Use REG_NOSUB if 4th arg to regexec() is NULL */ if (retval = regcomp(&rx, pat, REG_EXTENDED | REG_NOSUB)) { char buf[200]; regerror(retval, &rx, buf, 200); fprintf(stderr, "regex error: %s\n", buf); } else { if (regexec(&rx, s, 0, NULL, 0) == 0) printf("Party!\n"); regfree(&rx); } |
import "regexp" var rx = regexp.MustCompile("1999") if (rx.MatchString("It's 1999.")) { fmt.Println("Party!") } |
boolean isMatch = "hello".matches(".*ll.*"); |
| case insensitive match test | #include <regex.h> regex_t rx; int retval; char *pat = "lorem"; char *s = "Lorem"; if (retval = regcomp(&rx, pat, REG_EXTENDED | REG_ICASE)) { char buf[200]; regerror(retval, &rx, buf, 200); fprintf(stderr, "Regex error: %s\n", buf); } else { if (regexec(&rx, s, 0, NULL, 0) == 0) printf("case insensitive match\n"); regfree(&rx); } |
import "regexp" var rx = regexp.MustCompile("(?i)lorem") if (rx.MatchString("Lorem Ipsum")) { fmt.Println("case insensitive match") } |
|
| modifiers | /* bit flags used in 3rd arg of regcomp(): */ REG_BASIC REG_EXTENDED REG_ICASE REG_NOSUB REG_NEWLINE |
// use (?i), (?m), ... to insert in regex: i m s U |
|
| substitution | import "regexp" s := "do re mi mi mi" var rx = regexp.MustCompile("mi") fmt.Println(rx.ReplaceAllString(s, "ma")) |
String s1 = "hello".replace("ll","LL"); String s2 = "hello".replaceAll("l","L"); |
|
| group capture | #include <regex.h> regex_t rx; int retval; char *pat = "([0-9]{4})-([0-9]{2})-([0-9]{2})"; char *s = "2010-06-03"; if (retval = regcomp(&rx, pat, REG_EXTENDED)) { char buf[200]; regerror(retval, &rx, buf, 200); fprintf(stderr, "Regex error: %s\n", buf); } else { /* first match is entire pattern */ regmatch_t matches[4]; if (regexec(&rx, s, 4, matches, 0) == 0) { char yr[5]; regmatch_t rm = matches[1]; /* rm_so and rm_eo contain index of start and end of match; they are set to -1 if unused */ strncpy(yr, s + rm.rm_so, rm.rm_eo - rm.rm_so); yr[5] = '\0'; printf("year is %s\n", yr); } regfree(&rx); } |
||
| dates and time | |||
| c | go | java | |
| unix epoch type |
time_t | int64 | long |
| broken-down datetime type | struct tm | Time | java.util.Date |
| current unix epoch | time_t now; if (time(&now) == -1) perror("time failed"); |
import "time" t := time.Now().Unix() |
long epoch = System.currentTimeMillis() / 1000; |
| current datetime | import "time" dt := time.Now() |
import java.util.Date; long millis = System.currentTimeMillis(); Date dt = new Date(millis); |
|
| broken-down datetime to unix epoch | /* use host local time as tz: */ time_t t = mktime(&dt); /* use UTC as tz: */ time_t t2 = timegm(&dt2); |
t := dt.Unix() | long epoch = dt.getTime() / 1000; |
| unix epoch to broken-down datetime | struct tm dt, dt2; if (!localtime_r(&now, &dt)) perror("localtime_r failed"); /* UTC: */ if (!gmtime_r(&now, &dt2)) perror("gmtime_r failed"); |
var t int64 = 1421929926 var ns int64 = 0 dt := time.Unix(t, ns) |
Date dt2 = new Date(epoch * 1000); |
| format datetime | char buf[100]; char *fmt = "%Y-%m-%d %H:%M:%S"; if (!strftime(buf, 100, fmt, &dt)) fputs("strftime failed\n", stderr); |
layout := "2006-01-02 15:04:05" fmt.Println(dt.Format(layout)) |
String s = "yyyy-MM-dd HH:mm:ss"; DateFormat fmt = new SimpleDateFormat(s); String s2 = fmt.format(dt); |
| parse datetime | char *s = "1999-09-10 23:30:00"; char *fmt = "%Y-%m-%d %H:%M:%S"; char *p = strptime(s, fmt, &dt3); if (!p) fputs("strptime failed\n", stderr); |
layout := "2006-01-02:15:04:05" dt, err := time.Parse(layout, "1999-09-10 23:30:00") |
String s = "2011-05-03 17:00:00"; Date dt2 = fmt.parse(s); |
| date subtraction | /* use mktime for local; timegm for utc: */ double delta_sec = difftime(mktime(&dt), mktime(&dt2)); |
var delta time.Duration delta = dt.Sub(dt2) |
difference in milliseconds as a long: dt2.getTime() - dt.getTime() |
| add duration | dt.tm_sec += 1000; mktime(&dt); dt.tm_hour += 1000; mktime(&dt); dt.tm_mday += 1000; mktime(&dt); |
dt2 := dt + 1000 * time.Second dt3 := dt + 1000 * time.Hour |
long day_ms = 24 * 3600 * 1000; Date dt = new Date(dt.getTime() + day_ms)); |
| date parts | int yr = dt.tm_year + 1900; int mo = dt.tm_mon + 1; int dy = dt.tm_mday; |
yr := dt.Year() var mo time.Month = dt2.Month() dy := dt.Day() |
import java.util.Date; import java.util.Calendar; import java.util.GregorianCalendar; Date dt = new Date(); GregorianCalendar cal = new GregorianCalendar(); cal.setTime(dt); cal.get(Calendar.YEAR) cal.get(Calendar.MONTH) + 1 cal.get(Calendar.DAY_OF_MONTH) |
| time parts | int hr = dt.tm_hour; int mi = dt.tm_min; int ss = dt.tm_sec; |
hr := dt.Hour() mi := dt.Minute() ss := dt.Second() |
import java.util.Date; import java.util.Calendar; import java.util.GregorianCalendar; Date dt = new Date(); GregorianCalendar cal = new GregorianCalendar(); cal.setTime(dt); cal.get(Calendar.HOUR_OF_DAY) cal.get(Calendar.MINUTE) cal.get(Calendar.SECOND) |
| build broken-down datetime | dt.tm_year = 1999 - 1900; dt.tm_mon = 9 - 1; dt.tm_mday = 10; dt.tm_hour = 23; dt.tm_min = 30; dt.tm_sec = 0; dt.tm_isdst = 1; dt.tm_gmtoff = -7 * 60 * 60; if (mktime(&dt) == -1) fputs("mktime failed\n", stderr); |
import "time" yr := 1999 var mo time.Month = 9 dy, hr, mi, ss, ns := 10, 23, 30, 0, 0 loc, _ := time.LoadLocation("Local") dt := time.Date(yr, mo, dy, hr, mi, ss, ns, loc) |
import java.util.GregorianCalendar; int yr = 2015, mo = 5, dy = 31; int hr = 9, mi = 0, ss = 0; GregorianCalendar cal = new GregorianCalendar(yr, mo - 1, dy, hr, mi, ss); Date dt = cal.getTime(); |
| local time zone determination | On a Unix system, the local time zone is stored in /etc/localtime. A process can have a different local time zone by setting the TZ environment variable. | ||
| time zone info name and utc offset in hours |
offset abbreviation: dt.tm_zone UTC offset in hours: dt.tm_gmtoff / 3600.0 |
name, offset_sec := dt.Zone() offset abbreviation: name UTC offset in hours: offset_sec / 3600.0 |
|
| daylight savings test |
dt.tm_isdst | ||
| microseconds | #include <sys/time.h> struct timeval t; if (gettimeofday(&t, NULL) == -1) perror("gettimeofday failed"); else printf("epoch: %lu usec: %u\n", t.tv_sec, t.tv_usec); |
dt.Nanosecond() / 1000 | |
| fixed-length arrays | |||
| c | go | java | |
| declare | int a[10]; | // values are zero-initialized: var a [10]int |
|
| allocate on stack | /* contents of memory undefined: */ int a[10]; |
compiler decides location in memory | none |
| allocate on heap | #include <stdlib.h> /* memory zero-initialized: */ int *a = calloc(10, sizeof *a); |
compiler decides location in memory | all arrays allocated on heap |
| free heap |
free(a); | none; garbage collected | none; garbage collected |
| literal |
int a[] = {1, 2, 3}; | none | |
| size |
sizeof(a) / sizeof(a[0]) | len(a) | |
| lookup |
a[0] | a[0] | |
| update |
a[0] = 4; | a[0] = 4 | |
| out-of-bounds behavior | undefined, possible SIGSEGV | panic: index out of range if compiler detects a problem the code won't compile |
|
| element index | char *a[3] = {"foo", "bar", "baz"}; int loc = -1, i; for (i = 0; i < 3; ++i) { if (strcmp("bar", a[i]) == 0) { loc = i; break; } } |
var a [3]string a[0] = "foo" a[1] = "bar" a[2] = "baz" loc := -1 for i, val := range a { if val == "bar" { loc = i } } |
|
| copy | int a[3] = {1, 2, 3}; int b[3]; memcpy(b, a, sizeof(a)); |
a := []int{1, 2, 3} a2 := a // also sets a[0] to 4: a2[0] = 4 a3 := make([]int, len(a)) copy(a3, a) // a[0] is unchanged: a3[0] = 5 |
|
| iterate over elements | int a[10]; for (i = 0; i < 10; ++i ) { a[i] = i * i; } |
var a [10]int for i, _ := range a { a[i] = i * i } for _, num := range a { fmt.Printf("%d\n", num) } |
|
| sort | int compare(const void *a, const void *b) { if (*(int *)a < *(int *)b) { return -1; } else if (*(int *)a == *(int *)b) { return 0; } else { return 1; } } int a[5] = {6, 8, 10, 9, 7}; /* 2nd arg is array length; 3rd arg is element size */ qsort(a, 5, sizeof (int), &compare); |
convert to resizable array | |
| resizable arrays | |||
| c | go | java | |
| declare | // Resizable arrays are called slices. // To declare a slice instead of a fixed-length array, // omit the length from the type: var a []int // slice of length 5; capacity 10: a = make([]int, 5, 10) |
||
| literal |
a := []int{1, 2, 3} | ||
| size |
len(a) // number of elements that can be stored in allocated memory; // runtime reallocates when needed: cap(a) |
vec.size() | |
| lookup |
a[0] | vec.elementAt(0) | |
| update |
a[0] = 4 | ||
| resizable to fixed array | resizable := []int{1, 2, 3} var fixed [3]int copy(fixed[:], resizable) |
||
| fixed to resizable array | var resizable2 []int resizable2 = fixed[:] |
||
| out-of-bounds behavior |
Both lookups and updates cause panics when out-of-bounds | throws ArrayIndexOutOfBoundsException | |
| element index | a := []string{"foo", "bar", "baz"} loc := -1 for i, val := range a { if val == "bar" { loc = i } } |
||
| slice | a := []string{"a", "b", "c", "d", "e"} // {"c", "d"}: a2 := a[2:4] |
||
| slice to end | a := []string{"a", "b", "c", "d", "e"} // {"c", "d", "e"}: a2 := a[2:] |
||
| manipulate back | a := []int{1, 2, 3} a = append(a, 4) num := a[len(a) - 1] a = a[:len(a) - 1] |
vec.add("hello"); or vec.add(vec.size(), "hello"); vec.removeElementAt(vec.size()-1); |
|
| manipulate front | a := []int{1, 2, 3} a = append([]int{0}, a...) num := a[0] a = a[1:] |
||
| concatenate | a := []int{1, 2, 3} a2 := []int{4, 5, 6} a3 := append(a, a2...) |
||
| copy | a := []int{1, 2, 3} a2 := a // also sets a[0] to 4: a2[0] = 4 a3 := make([]int, len(a)) copy(a3, a) // a[0] is unchanged: a3[0] = 5 |
||
| iterate over elements | a := []string{"do", "re", "mi"} for _, s := range(a) { fmt.Printf("value: %s\n", s) } |
for ( String s : vec ) { do something with s } |
|
| iterate over indices and elements | a := []string{"do", "re", "mi"} for i, s := range(a) { fmt.Printf("value at %d: %s\n", i, s) } |
||
| reverse | import "sort" a := []int{1, 2, 3} sort.Sort(sort.Reverse(sort.IntSlice(a))) |
||
| sort | unsortedInts := []int{3, 1, 4, 2} sortedInts := sort.IntSlice(unsortedInts) sort.Sort(sortedInts) // sortedInts is now []int{1, 2, 3, 4} floats := []float64{3.0, 1.0, 4.0, 2.0} sort.Float64s(floats) // floats is now []float64{1.0, 2.0, 3.0, 4.0} strs := []string{"b", "a", "d", "c"} sort.Strings(strs) // strs is now []string{"a", "b", "c", "d"} |
||
| dictionaries | |||
| c | go | java | |
| declare |
d := make(map[string]int) | ||
| literal |
d := map[string]int {"t": 1, "f": 0} | ||
| size |
len(d) | m.size() | |
| lookup |
d["t"] | m.put("hello", 5); m.get("hello") |
|
| update |
d["t"] = 2 | ||
| missing key behavior |
returns zero value for value type | null | |
| is key present | // If key not present, val will contain // zero value for type and ok will contain false: val, ok = d["y"]] |
||
| delete |
delete(d, "f") | m.remove("hello"); | |
| iterate | for k, v := range d { fmt.Printf("%s: %d\n", k, v) } |
for ( java.util.Map.Entry<String, Integer> e : m.entrySet() ) { use e.getKey() or e.getValue() } |
|
| functions | |||
| c | go | java | |
| standard file handles | stdin stdout stderr | import "os" os.Stdin os.Stdout os.Stderr |
System.in System.out System.err |
| read line from stdin | char *line = NULL; size_t cap = 0; ssize_t len; /* if line is not NULL, it should be memory allocated by malloc and the size should be in cap. If size is not sufficient getline will call realloc on line */ len = getline(&line, &cap, stdin); if (len == -1) { if (ferror(stdin)) { perror("getline err"); } else if (feof(stdin)) { fprintf(stderr, "end of file\n"); } } else { /* use line here */ free(line); } |
import "bufio" import "os" var line string var err error b := bufio.NewReader(os.Stdin) line, err = b.ReadString('\n') if err != nil { os.Stderr.WriteString("error!") } else { // use line here } |
|
| write line to stdout | /* returns EOF on error */ int retval = puts("Hello, World!"); |
import "os" os.Stdout.WriteString("Hello, World!\n") |
|
| write formatted string to stdout |
printf("count: %d\n", 7); wprintf(L"count: %d\n", 7); |
fmt.Printf("count: %d\n", 7) | System.out.printf("count: %d", 7); |
| open file for reading | /* returns NULL on error */ FILE *f = fopen("/etc/hosts", "r"); |
import "os" raw, err := os.Open("/etc/hosts") if err == nil { f := bufio.NewReader(raw) } |
|
| open file for writing | /* returns NULL on error */ FILE *f = fopen("/tmp/test", "w"); |
import "os" perms := os.O_RDWR | os.O_CREATE f, err := os.OpenFile("/tmp/test", perms, 0644) |
|
| open file for appending | /* returns NULL on error */ FILE *f = fopen("/tmp/err.log", "a"); |
import "os" perms := os.O_RDWR | os.O_CREATE | os.O_APPEND f, err := os.OpenFile("/tmp/test", perms, 0644) |
|
| close file | /* returns EOF on error */ int retval = fclose(f); |
err := f.Close() | |
| i/o errors | Functions return values such as EOF, NULL, or -1 to indicate error. Some functions return the value of errno. In some cases errors are not distinguished from end-of-file. The functions ferror() and feof() can be used to test a file handle. The type of error is stored in errno. strerror(errno) or the thread safe strerror_r(errno, buf, buflen) convert the errors code to a string and perror() writes its argument to stderr with sterror(errno). |
||
| read line | char line[BUFSIZ]; if (fgets(line, BUFSIZ, f) == NULL) { if (ferror(stdin)) { perror("getline err"); } else if (feof(stdin)) { fprintf(stderr, "end of file\n"); } } else { if ('\n' == line[strlen(line) - 1]) { /* use line here */ } else { fprintf(stderr, "long line truncated\n"); } |
||
| iterate over file by line | |||
| read file into array of strings | |||
| read file into string | |||
| write string | /* returns EOF on error */ int retval = fputs("Hello, World!", f); |
bytes_written, err := f.WriteString("Hello, World!") bytes_written, err := f.Write(byte[]("Hello, World!")) |
|
| write line | /* returns EOF on error */ int retval = fputs("Hello, World!\n", f); |
bytes_written, err := f.WriteString("Hello, World!\n") bytes_written, err := f.Write(byte[]("Hello, World!\n")) |
|
| flush file handle | if (fflush(f) == EOF) { perror("fflush failed"); } |
err := f.Sync() | |
| end-of-file test |
feof(f) | ||
| get and set file handle position | long pos; if ((pos = ftell(f)) == -1) { perror("ftell failed"); } /* 3rd arg can also be SEEK_CUR or SEEK_END */ if (fseek(f, 0, SEEK_SET) == -1) { perror("fseek failed"); } |
||
| open unused file | #include <limits.h> /* PATH_MAX */ #include <unistd.h> char buf[PATH_MAX]; strcpy(buf, "/tmp/foo.XXXXXX"); /* terminal Xs will be replaced: */ int fd = mkstemp(buf); if (fd != -1) { FILE *f = fdopen(fd, "w"); if (NULL == f) { perror("fdopen failed"); } else { /* use f */ } } else { perror("mkstemp failed"); } |
||
| files | |||
| c | go | java | |
| file test, regular file test |
#include <sys/stat.h> #include <unistd.h> /* access() */ struct stat buf; if (access("/tmp/foo", F_OK) >= 0) { /* file exists */ } if (stat("/tmp/foo", &buf) != 0) { perror("stat failed"); } else if (S_ISREG(buf.st_mode)) { /* file is regular */ } |
import "os" fi, err := os.Stat("/tmp/foo") if os.IsNotExist(err) { fmt.Printf("Does not exit\n") } else { fmt.Printf("Exists\n") fm := fi.Mode() if fm.IsRegular() { fmt.Printf("Is Regular") } else { fmt.Printf("Is Not Regular") } } |
import java.io.File; File f = new File("/etc/hosts"); f.exists() f.isFile() |
| file size |
#include <sys/stat.h> struct stat buf; if (stat("/tmp/foo", &buf) != 0) { perror("stat failed"); } else { printf("size: %llu\n", buf.st_size); } |
fi.Size() | import java.io.File; File f = new File("/etc/hosts"); f.length() |
| is file readable, writable, executable | #include <unistd.h> if (access("/etc/hosts", R_OK) != 0) { printf("not readable\n"); } if (access("/etc/hosts", W_OK) != 0) { printf("not writable\n"); } if (access("/etc/hosts", X_OK) != 0) { printf("not executable\n"); } |
||
| set file permissions | #include <sys/stat.h> if (chmod("/tmp/foo", 0755) == -1) { perror("chmod failed"); } |
import "os" err := os.Chmod("/tmp/foo", 0755) if err != nil { fmt.Printf("Chmod failed\n") } |
import java.io.File; File f = new File("/tmp/foo"); // sets owner perms; to turn perms off // set arg to false: f.setReadable(true); f.setWritable(true); f.setExecutable(true); // if 2nd arg is false, perms are // for owner, group, and other: f.setReadable(true, false); f.setWritable(true, false); f.setExecutable(true, false); |
| last modification time | |||
| copy file, remove file, rename file | /* no copy function in standard library */ if (remove("/tmp/foo")) { perror("remove failed"); } if (rename("/tmp/bar", "/tmp/foo")) { perror("rename failed"); } |
import "os" // no copy function in standard library err := os.Remove("/tmp/foo") if err != nil { fmt.Printf("Remove failed: %s\n", err) } err2 := os.Rename("/tmp/bar", "/tmp/foo") if err2 != nil { fmt.Printf("Rename failed: %s\n", err2) } |
import java.io.File; ?? File f2 = new File("/tmp/foo"); f2.delete(); File f3 = new File("/tmp/bar"); f3.renameTo(new File("/tmp/bar")); |
| create symlink, symlink test, readlink | #include <limits.h> /* PATH_MAX */ #include <sys/stat.h> #include <unistd.h> if (symlink("/etc/hosts", "/tmp/hosts") == -1) { perror("symlink failed"); } struct stat sbuf; if (stat("/tmp/hosts", &buf) != 0) { perror("stat failed"); } else if (S_ISLNK(buf.st_mode)) { /* file is symlink */ } char pbuf[PATH_MAX + 1]; ssize_t size = readlink("/tmp/hosts", pbuf, PATH_MAX); if (size >= 0 ) { pbuf[size] = 0; /* pbuf now contains null-terminated string with target path */ } |
import "os" err := os.Symlink("/etc/hosts", "/tmp/hosts") if err != nil { fmt.Printf("Symlink failed: %s\n", err) } fi, err2 := os.Lstat("/tmp/hosts") if err2 == nil { fm := fi.Mode() if fm & os.ModeSymlink != 0 { fmt.Println("File is a Symlink") } } else { fmt.Printf("Lstat failed: %s\n", err2) } s, err3 := os.Readlink("/tmp/hosts") if err3 != nil { fmt.Printf("Readlink failed: %s\n", err3) } else { fmt.Printf("Link target: %s\n", s) } |
|
| generate unused file name | /* if first argument is NULL, path is in system temp directory. Caller should free() return value. */ char *path = tempnam("/tmp", "foo"); |
import "io/ioutil" // Uses system tmp dir if 1st arg is empty string: f, err := ioutil.TempFile("/tmp", "foo") if err == nil { fmt.Printf("writing to: %s\n", f.Name()) f.WriteString("foo content") } |
|
| file formats | |||
| c | go | java | |
| parse json | import "encoding/json" type TruthTable struct { T int `json:T` F int `json:F` } bytes := []byte(‘{"T": 1, "F": 0}`) var truthTable TruthTable err := json.Unmarshal(bytes, &truthTable) |
||
| generate json | import "encoding/json" type TruthTable struct { T int `json:T` F int `json:F` } truthTable := TruthTable{T: 1, F: 0} bytes, err := json.Marshal(truthTable) |
||
| directories | |||
| c | go | java | |
| working directory | import "os" dir, err := os.Getwd() if err != nil { os.Stderr.WriteString("Gtwd failed\n") } else { fmt.Printf("pwd: %s\n", dir) } err2 := os.Chdir("/tmp") if err2 != nil { os.Stderr.WriteString("Chdir failed\n"); } |
||
| build pathname | import "path" pathname := path.Join("/etc", "hosts") fmt.Printf("path: %s\n", pathname) |
import java.io.File; File root = File.listRoots()[0]; File etc = new File(root, "etc"); File hosts = new File(etc, "hosts"); String path = hosts.getPath(); |
|
| dirname and basename | #include <libgen.h> char *s1 = strdup("/etc/hosts"); char *s2 = strdup("/etc/hosts"); /* Check whether s1 or s2 are NULL. */ /* Some implementations return pointers to statically allocated memory which is overwritten by subsequent calls; others modify the input string. */ char *s3 = dirname(s1); char *s4 = basename(s2); |
import "path" path.Dir("/etc/hosts") path.Base("/etc/hosts") |
import java.io.File; File f = new File("/etc/hosts"); String dirname = f.getParent(); String basename = f.getName(); |
| absolute pathname | char *s; if ((s = realpath("..", NULL)) == NULL) { perror("realpath failed"); } else { /* use s */ } |
import java.io.File; File f = new File("foo"); String abspath = f.getAbsolutePath(); // getCanonicalPath() expands .. and .: File f2 = new File("../foo"); String abspath2 = f2.getCanonicalPath(); File f3 = new File("./foo"); String abspath3 = f3.getCanonicalPath(); |
|
| iterate over directory by file | #include <dirent.h> DIR *dir = opendir("/etc"); struct dirent *de; while (de = readdir(dir)) { printf("%s\n", de->d_name); } closedir(dir); |
import "io/ioutil" a, err := ioutil.ReadDir("/etc") if err == nil { for _, fi := range a { fmt.Printf("name: %s\n", fi.Name()) } } |
|
| glob paths | #include <glob.h> glob_t pglob; int i; glob("/etc/*", 0, NULL, &pglob); for (i = 0; i < pglob.gl_pathc; ++i) { printf("%s\n", pglob.gl_pathv[i]); } globfree(&pglob); |
import "path/filepath" a, err := filepath.Glob("/etc/*") if err == nil { for _, path := range(a) { fmt.Printf("path: %s\n", path) } } |
|
| make directory | #include <sys/stat.h> if (mkdir("/tmp/foo")) { fprintf(stderr, "mkdir err: %s\n", strerror(errno)); } |
err := os.Mkdir("/tmp/foo", 0775) if err != nil { fmt.Printf("Mkdir failed: %s\n", err) } |
import java.io.File; File f = new File("/tmp/foo/bar"); f.mkdirs(); |
| recursive copy | |||
| remove empty directory | #include <unistd.h> if (rmdir("/tmp/foo") == -1) { perror("rmdir failed"); } |
err := os.Remove("/tmp/foo") if err != nil { fmt.Printf("Remove failed: %s", err) } |
|
| remove directory and contents | err := os.RemoveAll("/tmp/foo") if err != nil { fmt.Printf("RemoveAll failed: %s", err) } |
||
| directory test |
#include <sys/stat.h> struct stat buf; if (stat("/tmp/foo", &buf) != 0) { perror("stat failed"); } else if (S_ISDIR(buf.st_mode)) { /* file is directory */ } |
import java.io.File; File f = new File("/tmp"); f.isDirectory() |
|
| generate unused directory | #include <limits.h> char buf[PATH_MAX]; strcpy(buf, "/tmp/fooXXXXXX"); /* terminal Xs will be replaced: */ if (mkdtemp(buf) == NULL) { perror("mkdtemp failed"); } else { /* use buf */ } |
import "io/ioutil" // Uses system tmp dir if 1st arg is empty string: path, err := ioutil.TempDir("/tmp", "foo") if err == nil { fmt.Printf("dir path: %s\n", path) } |
|
| system temporary file directory | /* defined in <stdio.h> */ P_tmpdir |
import "os" path := os.TempDir() |
|
| processes and environment | |||
| c | go | java | |
| command line arguments | int main(int argc, char **argv) { if (argc > 1) printf("first arg: %s\n", argv[1]); return 0; } |
import "os" if len(os.Args) > 1 { fmt.Printf("first arg: %\n", os.Args[1]) } |
|
| program name | int main(int argc, char **argv) { printf("program name: %s\n", argv[0]); return 0; } |
import "os" fmt.Printf("program name: %s\n", os.Args[0]) |
|
| environment variable | #include <stdlib.h> char *home = getenv("HOME"); setenv("EDITOR", "emacs", 1); unsetenv("EDITOR"); |
import "os" home := os.Getenv("HOME") err := os.Setenv("EDITOR", "emacs") if err != nil { fmt.Printf("Setenv failed: %s\n", err) } |
|
| iterate over environment variables | extern char **environ; char **env, *p, *key; for (env = environ; *env; ++env) { p = strchr(*env, ’='); if (p) { size_t keylen = p - *env; key = strndup(*env, keylen); printf("key: %s value: %s\n", key, *env + keylen + 1); free(key); } } |
import "os" import "strings" for _, s := range os.Environ() { a := strings.SplitN(s, "=", 2) fmt.Printf("key: %s value: %s\n", a[0], a[1]) } |
|
| get user id and name | #include <unistd.h> /* getlogin */ printf("uid: %d\n", getuid()); printf("username: %s\n", getlogin()); |
import "os" os.Getuid() /* username? */ |
|
| exit | /* use 0 for success; 1 through 127 for failure */ exit(1); |
import "os" os.Exit(1) |
|
| executable test | #include <unistd.h> if (access("/bin/ls", X_OK) != 0) { printf("not executable\n"); } |
||
| external command | /* retval of -1 indicates fork or wait failed. 127 indicates shell failed */ int retval = system("ls -l *"); |
||
| fork | |||
| exec | |||
| pipe | |||
| wait | |||
| get pid, parent pid | #include <unistd.h> /* getpid() and getppid() have return type pid_t */ printf("%d\n", getpid()); printf("%d\n", getppid()) |
import "os" fmt.Println(os.Getpid()) fmt.Println(os.Getppid()) |
|
| set signal handler | #include <signal.h> /* assumes a POSIX environment */ void handle_signal(int signo) { int restore = errno; switch(signo) { case SIGUSR1: write(1, "caught SIGUSR1\n", 15); break; default: break; } errno = restore; } /* 2nd arg can also be SIG_IGN or SIG_DFL */ sig_t prev_handler = signal(SIGUSR1, &handle_signal); if (prev_handler == SIG_ERR) { perror("signal failed"); exit(1); } |
||
| send signal | #include <signal.h> #include <unistd.h> /* getppid */ if (kill(getppid(), SIGUSR1) == -1) { perror("kill failed"); } |
||
| option parsing | |||
| c | go | java | |
| getopt | #include <getopt.h> /* 2nd value indicates whether option takes an argument */ static struct option long_opts[] = { {"debug", no_argument, NULL, 'd'}, {"threshold", required_argument, NULL, 't'}, {0, 0, 0, 0} }; int debug = 0; double threshold = 0.0; char *file = NULL; int ch; int opti; char *endptr; while (1) { ch = getopt_long(argc, argv, "dt:", long_opts, &opti); if (-1 == ch) { break; } switch (ch) { case 'd': debug = 1; break; case 't': threshold = strtod(optarg, &endptr); if (*endptr != 0) { fprintf(stderr, "expected float: %s\n", optarg); exit(1); } break; default: fprintf(stderr, "unexpected arg: %d\n", ch); exit(1); } } /* optind is index of 1st arg not consumed by getopt */ if (optind != argc - 1) { fputs("USAGE: foo [--multi] [--threshold=NUM] FILE\n", stderr); exit(1); } else { file = argv[optind]; } |
var debug bool var threshold int flag.BoolVar(&debug, "debug", false, "debug mode") flag.IntVar(&threshold, "threshold", 100, "threshold value") flag.Parse() // e.g. could call executable with // // -debug -threshold 200 |
|
| libraries and namespaces | |||
| c | go | java | |
| load library | /* The library must also be linked: $ gcc foo.o main.c If the library is in an archive: $ gcc -lfoo main.c */ #include "foo.h" |
import "foo" // Only capitalized identifiers are visible: var bar = foo.GetBar() |
|
| load library in subdirectory | #include "lib/foo.h" | import "lib/foo" | |
| library path | Add directory to path searched by #include directive: $ gcc -I/home/fred/include foo.c Add directory to path searched by -l (lowercase L) option: $ gcc -L/home/fred/lib -lbar foo.c |
The installation libraries are in the GOROOT directory. Additional directories can be listed in the GOPATH environment variable. The directories are separated by colons (semicolons) on Unix (Windows). Each directory contains a src subdirectory containing source code and potentially a pkg/ARCH subdirectory containing compiled libraries. |
|
| declare namespace | none | // A package declaration must be first statement // in every source file.. package foo |
|
| alias namespace |
none | import fu "foo" | |
| unqualified import of namespace | none | import . "foo" | |
| unqualified import of definitions | |||
| package manager search, install, list installed |
|||
| objects | |||
| c | go | java | |
| define class | // Methods can be defined for any Go type. // Thus a type definition can be regarded as a class definition. type Counter struct { value int } |
||
| create object |
cnt := Counter{value: 7} | ||
| define method | func (cnt Counter) Value() int { return cnt.value } // receiver must be pointer if method modifies it: func (cnt *Counter) Incr() { cnt.value++ } |
||
| invoke method | // same syntax for pointer and non-pointer receiver: cnt.Incr() |
||
| subclass | // An abstract superclass can be declared // using the interface keyword: type Incrementable interface { Incr() Value() int } func IncrAndPrint(incr Incrementable) { ) incr.Incr() fmt.Printf("incr: %d\n", incr.Value()) } cnt := Counter{value: 8} IncrAndPrint(&cnt) |
||
| user-defined types | |||
| c | go | java | |
| typedef | typedef int customer_id; customer_id cid = 3; |
type customer_id int var cid customer_id cid = 3 |
none |
| enum | enum day_of_week { mon, tue, wed, thu, fri, sat, sun }; enum day_of_week dow = tue; |
public enum DayOfWeek { MON, TUE, WED, THU, FRI, SAT, SUN }; DayOfWeek d = DayOfWeek.TUE; |
|
| struct definition | struct medal_count { const char* country; int gold; int silver; int bronze; }; |
type MedalCount struct { country string gold int silver int bronze int } |
|
| struct declaration |
struct medal_count spain; | ||
| struct initialization | struct medal_count spain = {"Spain", 3, 7, 4}; struct medal_count france = { .gold = 8, .silver = 7, .bronze = 9, .country = "France" }; |
spain := MedalCount{"Spain", 3, 2, 1} france := MedalCount{ bronze: 9, silver: 7, gold: 8, country: "France"} |
|
| struct literal | struct medal_count france; france = (struct medal_count) { .gold = 8, .silver = 7, .bronze = 9, .country = "France" }; |
||
| struct member assignment | spain.country = "Spain"; spain.gold = 3; spain.silver = 7; spain.bronze = 4; |
france := MedalCount{} france.country = "France" france.gold = 7 france.silver = 6 france.bronze = 5 |
|
| struct member access | int spain_total = spain.gold + spain.silver + spain.bronze; | france_total = france.gold + france.silver + france.bronze |
|
| c preprocessor macros | |||
| c | go | java | |
| include file | /* search path include system directories: */ #include <stdio.h> /* search path also includes directory of source file */ #include "foo.h" |
||
| add system directory | $ gcc -I/opt/local/include foo.c | ||
| define macro | #define PI 3.14 | ||
| command line macro | $ gcc -DPI=3.14 foo.c | ||
| undefine macro | #undef PI | ||
| macro with arguments | #define MIN(X, Y) ((X) < (Y) ? (X) : (Y)) | ||
| stringify macro argument | |||
| concatenate tokens | |||
| conditional compilation | #if defined __WIN32 win32_prinft("%f\n", x); #else printf("%f\n", x); #endif |
||
| macro operators | The conditional of #if can contain integer literals and the following operators: && || ! == != < > <= >= + - * / % << >> & | ^ ~ In addition, the defined() operator can be used to test whether a macro is defined. #ifdef FOO is a shortcut for #if defined(FOO) |
||
| net and web | |||
| c | go | java | |
| http get | import "io/ioutil" import "net/http" resp, err := http.Get("http://www.google.com") if err == nil { defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err == nil { fmt.Println(string(body)) } } |
||
| unit tests | |||
| c | go | java | |
| example | $ sudo apt-get install check $ cat > check_foo.c #include <check.h> START_TEST(test_foo) { fail_unless(0, "not true"); } END_TEST Suite * suite_foo(void) { Suite *ste = suite_create("suite: foo"); TCase *tc = tcase_create("case: foo"); tcase_add_test(tc, test_foo); suite_add_tcase(ste, tc); return ste; } int main(void) { int number_failed; Suite *ste = suite_foo(); SRunner *sr = srunner_create(ste); srunner_run_all(sr, CK_NORMAL); number_failed = srunner_ntests_failed(sr); srunner_free(sr); return (number_failed); } $ gcc -o check_foo check_foo.c -lcheck $ ./check_foo Running suite(s): foo 0%: Checks: 1, Failures: 1, Errors: 0 check_foo.c:4:F:foo:test_foo:0: not equal |
$ cat foo_test.go package foo import "testing" func TestFoo(t *testing.T) { t.Errorf("always fails") } $ go test - FAIL: TestFoo (0.00s) foo_test.go:6: always fails FAIL exit status 1 FAIL _/Users/john/Lang/Go 0.007s |
|
| debugging and profiling | |||
| c | go | java | |
| check syntax | $ gcc -fsyntax-only foo.c | $ go vet | |
| flag for stronger warnings | $ gcc -Wall foo.c | ||
| suppress warnings | $ gcc -w foo.c | ||
| treat warnings as errors | $ gcc -Werror foo.c | ||
| lint | $ sudo apt-get install splint $ splint foo.c |
||
| source cleanup | $ go fmt | ||
| run debugger | $ gcc -g -o foo foo.c $ gdb foo |
||
| debugger commands help, list source, (re)load executable, next, step, set breakpoint, show breakpoints, delete breakpoint, continue, backtrace, up stack, down stack, print, run, quit |
> h > l [FIRST_LINENO, LAST_LINENO] > file PATH > n > s > b [FILE:]LINENO > i > d NUM > c > bt > up > do > p EXPR > r [ARG1[, [ARG2 ...]] > q |
||
| benchmark code | #include <sys/times.h> #include <unistd.h> /* sysconf */ struct tms start, end; double ticks_per_s = (double)sysconf(_SC_CLK_TCK); clock_t start_wall = times(&start); if (start_wall < 0) { fputs("times failed", stderr); return (1); } int i; for (i = 0; i < 1000 * 1000 * 1000; ++i) { /* empty loop */ } clock_t end_wall = times(&end); if (end_wall < 0) { fputs("times failed", stderr); return (1); } clock_t wall = end_wall - start_wall; clock_t user = end.tms_utime - start.tms_utime; clock_t system = end.tms_stime - start.tms_stime; printf("wall: %f s\n", wall / ticks_per_s); printf("user: %f s\n", user / ticks_per_s); printf("system: %f s\n", system / ticks_per_s); |
$ cat foo_test.go package foo import "testing" func BenchmarkFoo(b *testing.B) { for i := 0; i < 1000 * 1000 * 1000; i++ { } } $ go test -bench . goos: darwin goarch: amd64 BenchmarkFoo-8 1000000000 0.29 ns/op PASS ok _/Users/john/Lang/go 3.709s |
|
| profile code | does not work on Mac OS X $ gcc -pg -o foo foo.c $ ./foo $ gprof foo |
$ cat foo_test.go package foo import "flag" import "fmt" import "testing" var cpuprofile = flag.String("cpuprofile", "", "") func Foo() int { for j := 0; j < 100; j++ { } return 1 } func BenchmarkFoo(b *testing.B) { for i := 0; i < 1000 * 1000 * 10; i++ { j := Foo() if j > 10 { fmt.Printf("Unexpected") } } } $ go tool pprof cpu.prof type "top" to see profile |
|
| memory tool | $ sudo apt-get install valgrind $ gcc -o foo foo.c $ valgrind foo |
||
| _________________________________________________________________ | _________________________________________________________________ | _________________________________________________________________ | |
| fixed-length arrays | |||
|---|---|---|---|
| java | |||
| declare on stack | arrays must be allocated on heap | ||
| declare on heap | int[] a = new int[10]; | ||
| free heap | garbage collected | ||
| initialization list | int[] a = {1,2,3}; | ||
| size | a.length | ||
| lookup |
a[0] | ||
| update |
|||
| out-of-bounds | ArrayIndexOutOfBoundsException | ||
| copy | |||
| as function argument | |||
| iterate | for (String name : names) { | ||
| sort | |||
| resizable arrays | |||
|---|---|---|---|
| java | |||
| declare | java.util.Vector<String> vec = new java.util.Vector<String>(); | ||
| initialization list | |||
| capacity get, increase |
|||
| empty test and clear |
|||
| element index | |||
| concatenate | |||
| replicate element | |||
| array as function argument | |||
| iterate over elements and indices | |||
| reverse | |||
| dedupe | |||
| membership | |||
| dictionaries | |||
|---|---|---|---|
| java | |||
| constructor | java.util.TreeMap<String, Integer> m = new java.util.TreeMap<String, Integer>(); | ||
| functions | |||
|---|---|---|---|
| java | |||
| declare | |||
| call |
|||
| define static class method | |||
| invoke static class method | |||
| default argument | use method overloading | ||
| pass by reference | objects and arrays are always passed by reference | ||
| recursive function | |||
| anonymous function | |||
| overload operator | none | ||
| execution control | |||
| java | |||
| break out of nested loops | |||
| exceptions | |||
| java | |||
|---|---|---|---|
| base exception | Any type which implements the interface java.lang.Throwable can be thrown. Exceptions thrown by the language and the standard libraries derive from java.lang.Errror or java.lang.Exception. |
||
| predefined exceptions | java.lang.Throwable java.lang.Error java.lang.Exception java.lang.IOException java.lang.RuntimeException java.lang.ArithmeticException java.lang.IllegalArgumentException java.lang.IndexOutOfBoundsException java.lang.NullPointerException |
||
| raise exception | throw new Exception("failed"); | ||
| handle exception | try { throw new Exception("failed"); } catch (Exception e) { System.out.println(e.getMessage()); } |
||
| define exception | |||
| re-raise exception | |||
| catch-all handler | |||
| multiple handlers | |||
| uncaught exception behavior | |||
| error message | |||
| system call errno | |||
| finally clause | try { risky code } finally { perform cleanup } |
||
| exception specification | yes |
| file handles | |||
|---|---|---|---|
| java | |||
| read from file | import java.io.BufferedReader; import java.io.FileReader; BufferedReader in = new BufferedReader(new FileReader("/etc/passwd")); String line; while ((line = in.readLine()) != null) { // process line } |
||
| write to file | import java.io.BufferedWriter; import java.io.FileWriter; BufferedWriter fout = new BufferedWriter(new FileWriter("/tmp/test2")); int i; for (i = 0; i < 10; i++) { fout.write(String.format("%d", i)); fout.newLine(); } fout.close(); |
||
| files | |||
|---|---|---|---|
| java | |||
| is file readable, writable, executable | import java.io.File; File f = new File("/etc/hosts"); f.canRead() f.canWrite() f.canExecute() |
||
| directories | |||
|---|---|---|---|
| java | |||
| iterate over directory by file | import java.io.File; File dir = new File("/etc"); // iterate over names: for (String name: dir.list()) { System.out.println(name); } // iterate over file objects: for (File f: dir.listFiles()) { System.out.println(f.getName()); } |
||
| processes and environment | |||
|---|---|---|---|
| java | |||
| signature of main | public class Foo { public static void main(String[] args) { |
||
| first argument |
first command line argument | ||
| environment variable | String home = System.getenv("HOME"); | ||
| iterate through environment variables | import java.util.Map; Map<String, String> env = System.getenv(); for (String name : env.keySet()) { String value = env.get(name)); } |
||
| libraries and namespaces | |||
|---|---|---|---|
| java | |||
| standard library name | Java API | ||
| declare namespace | package foo.bar; public class Baz { public static final int ANSWER = 42; } |
||
| multiple namespaces per file | no | ||
| namespaces map to directories | yes | ||
| import namespace | import foo.bar.*; System.out.println(Baz.ANSWER); |
||
| import part of namespace | none | ||
| import symbol | import foo.bar.Baz; System.out.println(Baz.ANSWER); |
||
| import static symbol | import static foo.bar.Baz.ANSWER; System.out.println(ANSWER); |
||
| import position |
after package and before type definitions | ||
| using a symbol that hasn't been imported | System.out.println(foo.bar.Baz.ANSWER); | ||
| application environment | |||
| multiple installations | set JAVA_HOME environment variable to directory containing a bin subdirectory with java, javac, and other command line tools. Put $JAVA_HOME/bin at front of search path. | ||
| user-defined types | |||
|---|---|---|---|
| java | |||
| struct definition | public class MedalCount { public String country; public int gold; public int silver; public int bronze; } |
||
| struct declaration | MedalCount spain = new MedalCount(); | ||
| struct initialization | no object literal syntax; define a constructor | ||
| struct member assignment | spain.country = "Spain"; spain.gold = 3; spain.silver = 7; spain.bronze = 4; |
||
| struct member access | int spain_total = spain.gold + spain.silver + spain.bronze; | ||
| generic types | |||
| java | |||
| define generic type | public class Foo<A> { public A a; public Foo(A a) { this.a = a; } } |
||
| instantiate generic type | Foo<String> f = new Foo<String>("foo"); | ||
| generic function | |||
| generic array | not permitted. Use Object as the element type for the array or use an ArrayList. | ||
| value parameter | |||
| template parameter | |||
| template specialization | |||
| multiple type parameters | |||
| generic type parameters | |||
| template parameters | |||
| variadic template | |||
| objects | |||
|---|---|---|---|
| java | |||
| semantics of == | object identity comparison | ||
| define class | public class Rational { public int num; public int denom; public Rational add(Rational o) throws Exception { return new Rational(this.num*o.denom + o.num*this.denom,this.denom*o.denom); } public static Rational max(Rational a, Rational b) { return (a.num*b.denom > a.num*b.denom) ? a : b; } } |
||
| class definition location | top level, class block, or function block for anonymous classes | ||
| constructor | public Rational(int n, int d) throws Exception { if (d == 0) { throw new Exception("zero denominator"); } if ( d < 0 ) { this.num = -1 * n; this.denom = -1 * d; } else { this.num = n; this.denom = d; } } |
||
| create object | Rational r = new Rational(7,3); | ||
| destructor | protected void finalize() throws Throwable { super.finalize(); } |
||
| destroy object |
none | ||
| define method | public int height() { return (Math.abs(this.num) > this.denom) ? Math.abs(this.num) : this.denom; } |
||
| invoke method | r.height(); | ||
| define class method | declare static in class definition | ||
| invoke class method | |||
| name of receiver | this | ||
| access control | access keywords required for methods and members: public class Foo { private int privateInt; protected int protectedInt; public int publicInt; } |
||
| anonymous class | (new Object() { public void hello() { System.out.println("hello!"); } }).hello(); | ||
| inheritance and polymorphism | |||
|---|---|---|---|
| java | |||
| dynamic dispatch | dispatch dynamic by default | ||
| static dispatch | declare as final, private, or static (i.e. make it a class method) | ||
| subclass | public class RInteger extends Rational { public RInteger(int n) throws Throwable { super(n, 1); } } |
||
| invoking superclass constructor | super(n, 1); | ||
| mark class underivable or method unoverrideable | final | ||
| root class |
java.lang.Object | ||
| root class methods | clone() equals() finalize() getClass() hashCode() toString() |
||
| reflection | |||
|---|---|---|---|
| java | |||
| get type class of object | o = new Object(); Class c = o.getClass(); |
||
| get type class from string | Class c = Class.forName("java.io.File"); | ||
| get type class from type identifier | |||
| class name |
String name = c.getName(); | ||
| get methods | import java.lang.reflect.*; Method[] m = c.getMethods(); |
||
| has method | import java.lang.reflect.*; Class c = Class.forName("java.io.File"); Method[] a = c.getMethods(); boolean hasMethod = false; for (int i=0; i < a.length; i++) { if (a[i].getName() == "toString") { hasMethod = true; } } |
||
| invoke method object | import java.lang.reflect.*; Class c = Class.forName("java.io.File"); Method m = c.getMethod("toString"); Object o = new Object(); m.invoke(o); |
||
| net and web | |||
| java | |||
| get local hostname, dns lookup, reverse dns lookup | |||
| http get | |||
| http post | |||
| absolute url | |||
| parse url | |||
| url encode/decode | import java.net.URLEncoder; import java.net.URLDecoder; String url = "http://www.google.com"; String s = URLEncoder.encode(url, "utf8"); String s2 = URLDecoder.decode(s, "utf8"); |
||
| base64 encode/decode | |||
Version
version used
The compiler version used for this cheatsheat.
show version
How to get the compiler version.
implicit prologue
Code which the examples in this sheet assume to have been executed.
c:
A selection of commonly used symbols and macros from the standard C library and the headers in which they are defined according to POSIX:
| errno.h | stdlib.h | stdio.h | string.h | time.h | wchar.h |
|---|---|---|---|---|---|
| errno ENOENT ENOMEM EACCES EINVAL EPIPE |
abs drand48 exit free getenv lrand48 malloc mkdtemp putenv qsort realpath srand strtod strtol system unsetenv |
fclose feof fflush fgets fopen fprintf fputs getc getline printf putc remove rename scanf BUFSIZ EOF NULL |
strcat strchr strcmp strcpy strdup strerror strncat strncmp strncpy strndup strrchr strstr strtok |
time time_t |
swprintf wcscmp wcsdup wcslen wprintf |
Grammar and Invocation
hello world
How to write, compile, and run a "Hello, World!" program.
file suffixes
The suffixes used for source files, header files, and compiled object files.
statement terminator
How statements are terminated.
block delimiters
How a block of statements is delimited.
end-of-line comment
The syntax for a comment which is terminated by the end of the line.
c:
The // style comment first appeared in the C99 standard.
multiple line comment
The syntax for a comment which can span multiple lines.
/* */ style comments cannot be nested in C or Go.
Variables and Expressions
variable
How to declare a variable.
free heap
How to free memory allocated on the heap.
global variable
How to declare a global variable.
uninitialized variable
What happens when reading from an uninitialized variable.
compile time constant
How to define a constant.
go:
Multiple constants can be declared in this manner:
const (
Pi = 3.14
E = 2.718
)
immutable variable
How to declare a variable which cannot change after initialization.
assignment
The syntax for assigning a value to a variable.
parallel assignment
The syntax for parallel assignment.
swap
How to swap the values in two variables.
compound assignment
The compound assignment operators.
increment and decrement
The increment and decrement operators.
null
The null literal and where the null value can be used.
c:
A typical definition:
#define NULL (void *)0
null test
How to test whether a value is null.
conditional expression
The syntax for a conditional expression.
Arithmetic and Logic
boolean type
c:
The following definitions are common:
typedef int BOOL;
#define TRUE 1
#define FALSE 0
true and false
Literals for the boolean values true and false.
c:
The following definitions are common:
typedef int BOOL;
#define TRUE 1
#define FALSE 0
falsehoods
Values which evaluate as false in the conditional expression of an if statement.
logical operators
The logical operators.
In all languages on this sheet the && and || operators short circuit: i.e. && will not evaluate the 2nd argument if the 1st argument is false, and || will not evaluate the 2nd argument if the 1st argument is true. If the 2nd argument is not evaluated, side-effects that it contains are not executed.
relational operators
Binary operators which return boolean values.
integer type
Signed integer types.
c:
Whether char is a signed or unsigned type depends on the implementation.
unsigned type
Unsigned integer types.
c:
Whether char is a signed or unsigned type depends on the implmentation.
float type
Floating point types.
arithmetic operators
The arithmetic binary operators.
integer division
How to find the quotient of two integers.
integer division by zero
The result of attempting to divide an integer by zero.
c:
The behavior for division by zero is system dependent; the behavior described is common on Unix.
float division
How to perform float division on integers.
float division by zero
The result of attempting to divide a float by zero.
power
How to perform exponentiation.
sqrt
The square root function.
sqrt -1
The result of attempting to find the square root of a negative nubmer.
transcendental functions
The exponential function; logarithm functions; trigonometric and inverse trigonometric functions.
transcendental constants
Constants for π and e.
float truncation
Functions for converting a float to a nearby integer value.
c:
The math.h library also provides floor and ceil which return double values.
absolute value
The absolute value of a numeric.
complex type
Complex floating point types.
complex construction
How to create a complex number.
c:
The C11 standard introduced macros for constructing complex numbers which work correctly when the arguments are inf, nan, or +nan:
double complex CMPLX(double x, double y)
float complex CMPLXF(float x, float y)
long double complex CMPLXL(long double x, long double y)
complex decomposition
How to decompose a complex number into its real and imaginary parts; how to get the argument and absolute value of a complex number; how to get its complex conjugate.
random number
How to generate a random integer from a uniform distribution; how to generate a random float from a uniform distribution.
random seed
How to set the random seed.
c:
There are at least three random number generators defined in stdlib.h. Each has its own function for setting the random seed:
srand(17); /* used by rand() */
srandom(17); /* used by random() */
srand48(17); /* used by drand48() and lrand48() */
bit operators
The bit operations: right shift, left shift, and, or, exclusive or, and not.
go:
Note that ^ is bit-not and not exclusive-or like in C.
binary, octal, and hex literals
Strings
string type
The type for a string.
c:
The C11 standard introduces char16_t and char32_t, but no literal syntax or functions which take them as arguments.
string literal
The syntax for a string literal.
go:
The backquote literal is also called the raw string literal. It has no escape sequences; it cannot contain a backquote character.
newline in string literal
Can newlines be included in string literals?
c:
The compiler will convert the following three string literals to the single literal "foobarbaz".
char *metavars = "foo"
"bar"
"baz";
string escapes
Escape sequences in string literals.
compare strings
c:
Returns 1, 0, or -1 depending upon whether the first string is lexicographically greater, equal, or less than the second. The variants strncmp, strcasecmp, and strncasecmp can perform comparisons on the first n characters of the strings or case insensitive comparisons.
string to number
c:
strtoimax, strtol, strtoll, strtoumax, strtoul, and strtoull take three arguments:
intmax_t
strtoimax(const char *str, char **endp, int base);
The 2nd argument, if not NULL, will be set to first character in the string that is not part of the number. The 3rd argument can specify a base between 2 and 36.
strtof, strtod, and strtold take three arguments:
double
strtod(const char *str, char **endp);
number to string
split
join
concatenate
replicate
extract substring
index of substring
format string
translate case
trim
pad
length
character type
The type for a character.
character literal
character lookup
character index
character tests
chr and ord
Regular Expressions
metacharacters
The list of regular expression metacharacters.
A regular expression that does not contain any metacharacters matches itself as a string.
character class abbrevations
Abbreviations for character classes.
c:
We describe the regex library which is mandated by POSIX.
The PCRE library is available or easily installed on most systems and provides Perl style regular expressions. In particular PCRE has these character class abbreviations: \d \D \h \H \s \S \v \V \w \W.
To install PCRE on Ubuntu and read the documentation:
$ sudo apt-get install pcre
$ man pcre
To include the PCRE definitions in a C file:
#include <pcre.h>
anchors
Metacharacters for matching locations in the string which aren't single characters or substrings.
match test
How to test whether a string matches a regular expression.
case insensitive match test
How to test whether a string matches a regular expression in a case insensitive manner.
modifers
Modifers which can be used to customize the behvaior of a regular expression.
go:
The meaning of the modifiers:
| i | case insensitive match |
| m | ^ and $ match begin and end of line in addition to begin and end of string |
| s | l. matches \n |
| U | make (foo)*, (foo)+ non-greedy and (foo)*?, (foo)+? greedy |
substitution
How to replace the part of a string matching a regular expression.
group capture
How to use a regular expression to parse a string.
Dates and Time
unix epoch type
broken-down datetime type
current unix epoch
current datetime
broken-down datetime to unix epoch
unix epoch to broken-down datetime
format datetime
parse datetime
date subtraction
add duration
date parts
time parts
build broken-down datetime
local time zone determination
time zone info
daylight savings test
microseconds
Fixed-Length Arrays
declare
How to declare an array variable.
allocate on stack
How to allocate an array on the stack.
allocate on heap
How to allocate an array on the heap.
free heap
How to free an array that was allocated on the heap.
literal
Syntax for an array literal.
size
How many elements are stored in an array.
lookup
How to get an element by index.
c:
Arrays can be manipulated with pointer syntax. The following sets x and y to the same value:
int a[] = {3,7,4,8,5,9,6,10};
int x = a[4];
int y = *(a+4);
update
How to set or change the element stored at an index.
out-of-bounds behavior
What happens when an attempt is made to access an element at an invalid index.
element index
slice
slice to end
manipulate back
manipulate front
concatenate
copy
iterate over elements
How to iterate over the elements of an array.
c:
C arrays do not store their size; if needed the information can be stored in a separate variable. Another option is to use a special value to mark the end of the array:
char *a[] = { "Bob", "Ned", "Amy", NULL };
int i;
for (i=0; a[i]; i++) {
printf("%s\n", a[i]);
}
reverse
How to reverse the elements of an array.
sort
How to sort the elements of an array.
Resizable Arrays
declare
How to declare a resizable array variable.
literal
Syntax for a resizable array literal.
size
How many elements are stored in a resizable array.
lookup
How to get an element by index.
c:
Arrays can be manipulated with pointer syntax. The following sets x and y to the same value:
int a[] = {3,7,4,8,5,9,6,10};
int x = a[4];
int y = *(a+4);
update
How to set or change the element stored at an index.
resizable to fixed array
How to convert a resizable array to a fixed array.
fixed to resizable array
How to convert a fixed array to a resizable array.
out-of-bounds behavior
What happens when an attempt is made to access an element at an invalid index.
element index
How to get the index of an element in a resizable array.
slice
How to slice a resizable array.
slice to end
How to slice a resizable array to the end.
manipulate back
How to add and remove elements from the back of a resizable array.
manipulate front
How to add and remove elements from the front of a resizable array.
concatenate
How to concatenate resizable arrays.
copy
How to copy a resizable array.
iterate over elements
How to iterate over the elements of a resizable array.
c:
C arrays do not store their size; if needed the information can be stored in a separate variable. Another option is to use a special value to mark the end of the array:
char *a[] = { "Bob", "Ned", "Amy", NULL };
int i;
for (i=0; a[i]; i++) {
printf("%s\n", a[i]);
}
iterate over indices and elements
How to iterate over the indices and elements of a resizable array.
reverse
How to reverse the elements of a resizable array.
sort
How to sort the elements of a resizable array.
Dictionaries
declare
literal
size
lookup
update
missing key behavior
is key present
delete
iterate
Functions
define function
How to define a function.
invoke function
How to invoke a function.
forward declaration of function
How to declare a function without defining it.
overload function
How to define multiple functions with the same name. The functions differ in either the number or type of arguments.
nest function
How to define a function inside another function.
default value for parameter
variable number of arguments
c:
The stdarg.h library supports variable length functions, but provides no means for the callee to determine how many arguments were provided. Two techniques for communicating the number of arguments to the caller are (1) devote one of the non-variable arguments for the purpose as illustrated in the table above, or (2) set the last argument to a sentinel value as illustrated below. Both techniques permit the caller to make a mistake that can cause the program to segfault. printf uses the first technique, because it infers the number of arguments from the number of format specifiers in the format string.
char* concat(char* first, ...) {
int len;
va_list ap;
char *retval, *arg;
va_start(ap, first);
len = strlen(first);
while (1) {
arg = va_arg(ap, char*);
if (!arg) {
break;
}
len += strlen(arg);
}
va_end(ap);
retval = calloc(len+1, sizeof *retval);
va_start(ap, first);
strcpy(retval, first);
len = strlen(first);
while (1) {
arg = va_arg(ap, char*);
if (!arg) {
break;
}
printf("copying %s\n", arg);
strcpy(retval+len, arg);
len += strlen(arg);
}
va_end(ap);
return retval;
}
An example of use:
string *s = concat("Hello", ", ", "World", "!", NULL);
named parameters
pass by value
pass by address
return value
How the return value for a function is determined.
no return value
How to define a function with no return value.
swift:
The return value can be explicitly declared as Void:
func print_err(err: String) -> Void {
println(err)
}
multiple return values
How to return multiple values.
named return values
How to return values by assigning values to variables.
execute on return
How to register a function to be executed on return of the calling function.
go:
Arguments of the on-return function are evaluated at the time the function is registered and not when the caller returns.
Multiple on-return functions are evaluated in LIFO order.
anonymous function literal
invoke anonymous function
function with private state
closure
function as value
Execution Control
if
The if statement.
An if statement is a series of blocks, each guarded by a conditional expression. The first conditional expression statement which evaluates to true determines the block which executes. An optional else block executes if none of the of the conditional expressions are true.
switch
The switch statement.
The switch statement has a switch expression which is evaluated against one or more case values. The first case value which is equal to the switch expression determines the block which executes. An optional default block executes if none of the case values are equal.
Note that in some languages, execution "falls through" to the next block in a switch unless prevented by a break statement.
go:
Case values can be expressions.
The switch statement can lack a switch expression, in which case the first case value which evaluates to true determines the block to execute. Such a switch statement differs little from an if statement, but note that fallthrough cannot be used in an if statement.
It is possible to switch on type of an expression, in which case the case values are types:
switch x.(type) {
case nil:
printString("x is nil")
case int:
printString("x is int")
case float64:
printFloat64("x is float64")
default:
printString("unknown type")
}
while
A while loop is a conditional expression and a block. The conditional expression is evaluated before each execution of the block. The block is executed iteratively as long as the conditional expression is true.
c:
C has a do-while statement. The block is always executed at least once. The conditional expression is evaluated before the second and subsequent iterations to determine if the block is executed again.
int i = 0;
do {
print("%d\n", ++i);
} while (i < 10);
If the body of a while loop consists of a single statement the curly braces are optional:
int i = 0;
while (i<10)
printf("%d\n", ++i);
for
A for loop has four parts: the initialization which executes at the outset, the condition which is evaluated before each iteration, the body which is executed if the condition is true, and the afterthought which is executed after each execution of the body.
for with local scope
Whether variables declared in the initialization are local to the body.
infinite loop
The syntax for an infinite loop.
break
A break statement is used to exit a loop.
break from nested loops
How to break out of nested loops.
continue
A continue statement is used to terminate the current iteration of a loop.
single statement branches and loops
dangling else
goto
longjmp
Concurrency
File Handles
standard file handles
The file handles for standard input, standard output, and standard error.
c:
POSIX systems provide processes with the ability to open multiple files and manipulate them with via integers called file descriptors. Normally the integers 0, 1, and 2 refer to standard input, standard output, and standard error. The header <unistd.h> defines the macros STDIN_FILENO, STDOUT_FILENO, and STDERR_FILENO for these file descriptors.
System calls take file descriptors as arguments, but the C standard library provides an alternate set functions for buffered I/O. The standard library functions use FILE structs to identify streams and open files.
read line from stdin
How to read a line from standard input.
write line to stdout
How to write a line to standard output.
write formatted string to stdout
How to print a formatted string to standard out.
c:
The printf man page describes the notation used in C style format strings.
open file for reading
How to open a file for reading.
open file for writing
How to open a file for reading.
open file for appending
How to open a file for appending.
close file
How to close a file handle.
close file implicitly
i/o errors
read line
iterate over file by line
read file into array of strings
read file into string
write string
write line
flush file handle
end-of-file test
get and set file handle position
open unused file
How to open a file with a previously unused file name.
c:
The function mkstemps can be used to create a new file with a fixed suffix: "/tmp/fooXXXXXXsuffix".
Files
file test, regular file test
Does the file exist; is the file a regular file.
file size
The size of the file in bytes.
is file readable, writable, executable
Can the process read, write, or executable the file?
c:
access returns 0 if the process has the permission, and -1 if it doesn't or some other error occurred.
access uses the real user id to determine permission even though the kernel uses the effective user id.
set file permissions
copy file, remove file, rename file
create symlink, symlink test, readlink
generate unused file name
File Formats
Directories
working directory
build pathname
dirname and basename
absolute pathname
iterate over directory by file
glob paths
make directory
recursive copy
remove empty directory
remove directory and contents
directory test
generate unused directory
system temporary file directory
Processes and Environment
first argument
c:
The first argument is the pathname to the executable. Whether the pathname is absolute or relative depends on how the executable was invoked. If the executable was invoked via a symlink, then the first argument is the pathname of the symlink, not the executable the symlink points to.
environment variable
iterate over environment variables
exit
How to set the exit status and cause the process to exit.
c:
On POSIX systems zero indicates success and other values indicate failure.
On Linux and Mac OS X the value returned to the parent is exit_arg & 0377. If the process exited because of a signal, the kernel sets the exit status to 128 plus the signal number. The signals are numbered starting from 1, leaving exit status values from 1 to 127 and perhaps 128 available for other failure conditions.
The C standard library defines the values EXIT_SUCCESS and EXIT_FAILURE as an aid for writing code which is portable to systems which do not use 0 to indicate success.
set signal handler
How to set a signal handler on a POSIX system.
A quirk about signal is that some systems (e.g. Solaris) do not leave the signal handler registered after handling a signal. Mac OS X and Linux do leave the signal handler registered.
For portability, one can used sigaction instead of signal.
Before writing a signal handler, review the list of permitted functions that you can call from the signal handler. The list is available in man 2 sigaction on Mac OS X and man 7 signal on Linux.
$ man 2 sigaction
$ man 7 signal
- re-entrant functions
- sigaction
send signal
Option Parsing
Libraries and Namespaces
load library
How to load a library.
c:
Loading a library is a two part process.
Library declarations are made available by including headers in the client code.
Linking is performed by listing the library objects with the client object containing the main function on the command line when invoked the linker.
Alternatively, library objects can be collected into archive files using the ar command. These files have a .a suffix. The -l (lowercase L) option is used to include an archive when linking.
go:
Multiple libraries can be loaded by listing them one after another:
import "fmt"
import "math/rand"
Alternatively a single import statement can be used:
import (
"fmt"
"math/rand"
)
load library in subdirectory
How to load a library in a subdirectory of the load path.
library path
How to the library path is specified.
declare namespace
How to declare the namespace of a source file.
alias namespace
How to import a namespace under an alias.
This can be used to provide an abbreviated name for a namespace.
It also allows a client to use two different libraries which declare the same namespace.
unqualified import of namespace
How to import all the identifiers in a library so that the client can refer to them without the namespace prefix.
Objects
define class
create object
define method
invoke method
subclass
User-Defined Types
typedef
c:
Because C integer types don't have well defined sizes, typedef is sometimes employed to as an aid to writing portable code. One might include the following in a header file:
typedef int int32_t;
The rest of the code would declare integers that need to be 32 bits in size using int32_t and if the code needed to be ported to a platform with a 16 bit int, only a single place in the code requires change. In practice the typedef abstraction is leaky because functions in the standard library such as atoi, strtol, or the format strings used by printf depend on the underlying type used.
enum
c:
Enums were added to the C standard when the language was standardized by ANSI in 1989.
An enum defines a family of integer constants. If an integer value is not explicitly provided for a constant, it is given a value one greater than the previous constant in the list. If the first constant in the list is not given an explicit value, it is assigned a value of zero. it is possible for constants in a list to share values. For example, in the following enum, a and c are both zero and b and d are both one.
enum { a=0, b, c=0, d };
A typedef can be used to make the enum keyword unnecessary in variable declarations:
typedef enum { mon, tue, wed, thu, fri, sat, sun } day_of_week;
day_of_week d = tue;
From the point of view of the C compiler, an enum is an int. The C compiler does not prevent assigning values to an enum type that are not in the enumerated list. Thus, the following code compiles:
enum day_of_week { mon, tue, wed, thu, fri, sat, sun };
day_of_week d = 10;
typedef enum { mon, tue, wed, thu, fri, sat, sun } day_of_week2;
day_of_week2 d2 = 10;
struct definition
A struct provides names for elements in a predefined set of data and permits the data to be accessed directly without the intermediation of getters and setters. C++, Java, and C# classes can be used to define structs by making the data members public. However, public data members violates the uniform access principle.
struct declaration
struct initialization
c:
The literal format for a struct can only be used during initialization. If the member names are not provided, the values must occur in the order used in the definition.
struct member assignment
struct member access
c:
The period operator used for member access has higher precedence than the pointer operator. Thus parens must be used to get at the member of a struct referenced by a pointer:
struct medal_count {
char* country;
int gold;
int silver;
int bronze;
}
struct medal_count spain = { "Spain", 3, 7 4 };
struct medal_count *winner = &spain;
printf("The winner is %s with %d gold medals", (*winner).country, (*winner).gold);
ptr->mem is a shortcut for (*ptr).mem:
printf("The winner (%s) earned %d silver medals", winner->country, winner->silver);
C Preprocessor Macros
Net and Web
http get
How to make an HTTP GET request.
Unit Tests
example
Debugging and Profiling
C
ANSI C Standard (pdf) 1999
GNU C Library
FREQUENTLY USED GCC and CLANG OPTIONS
-o name of output file
TYPE OF BUILD
-E stop after preprocessor; do not compile
-S stop after compilation; do not assemble
-c stop after assembly; do not link
PREPROCESSOR
-I add directory to list of directories containing header files
-D FOO define macro FOO as 1
-D FOO=VAL define macro FOO as VAL
-U FOO undefine macro FOO
-M output make dependency info
LINKER
-lfoo search library foo for symbols when liking
-L add directory to search path used by -l
WARNINGS
-w no warnings
-Werror make warnings errors
-Wall enable all warnings
DEBUGGING, PROFILING, and OPTIMIZATION
-g make object debuggable
-pg generate executable which produces output for gprof
-O1 -O2 -O2 spend progressively more time in compilation optimizing code
MAC SPECIFIC
-F add a framework directory (used in place of -I, -l, -L)
Go
Language Specification
Package Reference
Java
Java 1.6 API
JDK 7 Project
JVM Specification 2nd Ed
The Java Language Specification 3rd Ed
A Java program is created from source code via an explicit compilation step using javac. The executable is then launched using the virtual machine java. Both javac and java use the Java runtime jar rt.jar, which contains the Java standard libraries.
$ ls -l $(which javac)
-rwxrwxr-x 1 root wheel 99296 Oct 8 2013 /Library/JVM/jdk7.0/Contents/Home/bin/javac
$ ls -l $(which java)
-rwxrwxr-x 1 root wheel 99216 Oct 8 2013 /Library/JVM/jdk7.0/Contents/Home/bin/java
$ ls -l $JAVA_HOME/jre/lib/rt.jar
-rw-rw-r-- 1 root wheel 64181940 Oct 8 2013 /Library/JVM/jdk7.0/Contents/Home/jre/lib/rt.jar
$ cat Main.java
public class Main {
public static void main(String[] argv) throws Throwable {
System.out.println("Hello, World!");
}
}
$ javac Main.java
$ ls -l Main.class
-rw-r--r-- 1 hpglot staff 463 Dec 27 06:12 Main.class
$ java Main
Hello, World!
Using dtruss on Mac OS X to verify that javac and java use rt.jar:
$ sudo dtruss javac Main.java 2>&1 | grep -E '^open' | grep rt.jar
open("/Library/JVM/jdk7.0/Contents/Home/jre/lib/rt.jar\0", 0x0, 0x0) = 4 0
$ sudo dtruss java Main 2>&1 | grep -E '^open' | grep rt.jar
open("/Library/JVM/jdk7.0/Contents/Home/jre/lib/rt.jar\0", 0x0, 0x0) = 4 0