noarch

Documentation

Overview

Package noarch contains low-level functions that apply to multiple platforms.

Index

• Variables
• func Abs(n int) int
• func Asctime(tm []Tm) []byte
• func Atof(str []byte) float64
• func Atoi(str []byte) int
• func Atol(str []byte) int32
• func Atoll(str []byte) int64
• func BoolToInt(x bool) int
• func CPointerToGoPointer(a interface{}) interface{}
• func CStringIsNull(s []byte) bool
• func CStringToString(s []byte) string
• func Ctime(tloc []TimeT) []byte
• func Fclose(f *File) int
• func Feof(stream *File) int
• func Fflush(stream *File) int
• func Fgetc(stream *File) int
• func Fgetpos(f *File, pos []int) int
• func Fgets(str []byte, num int, stream *File) []byte
• func Fprintf(f *File, format []byte, args ...interface{}) int
• func Fputc(c int, f *File) int
• func Fputs(str []byte, stream *File) int
• func Fread(ptr *[]byte, size1, size2 int, f *File) int
• func Free(anything interface{})
• func Fscanf(f *File, format []byte, args ...interface{}) int
• func Fseek(f *File, offset int32, origin int) int
• func Fsetpos(stream *File, pos []int) int
• func Ftell(f *File) int32
• func Fwrite(str []byte, size1, size2 int, stream *File) int
• func Getchar() int
• func Getenv(name []byte) []byte
• func GoPointerToCPointer(destination interface{}, value interface{})
• func IsNaN(x float64) int
• func Labs(n int32) int32
• func Llabs(n int64) int64
• func NotInt(x int) int
• func NotUint16(x uint16) uint16
• func Printf(format []byte, args ...interface{}) int
• func Putchar(character int)
• func Puts(str []byte) int
• func Remove(filePath []byte) int
• func Rename(oldName, newName []byte) int
• func Rewind(stream *File)
• func Scanf(format []byte, args ...interface{}) int
• func Signbitd(x float64) int
• func Signbitf(x float32) int
• func Signbitl(x float64) int
• func Snprintf(buffer []byte, n int, format []byte, args ...interface{}) int
• func Sprintf(buffer, format []byte, args ...interface{}) int
• func Strcat(dest, src []byte) []byte
• func Strchr(str []byte, ch int) []byte
• func Strcmp(str1, str2 []byte) int
• func Strcpy(dest, src []byte) []byte
• func StringToCString(s string) []byte
• func Strlen(a []byte) int
• func Strncpy(dest, src []byte, len int) []byte
• func Strtod(str []byte, endptr [][]byte) float64
• func Strtof(str []byte, endptr [][]byte) float32
• func Strtol(str []byte, endptr [][]byte, radix int) int32
• func Strtold(str []byte, endptr [][]byte) float64
• func Strtoll(str []byte, endptr [][]byte, radix int) int64
• func Strtoul(str []byte, endptr [][]byte, radix int) uint32
• func Strtoull(str []byte, endptr [][]byte, radix int) uint64
• func Ternary(a bool, b, c func() interface{}) interface{}
• func TimeTToFloat64(t TimeT) float64
• func Tmpnam(str []byte) []byte
• func Vsnprintf(buffer []byte, n int, format []byte, varList ...interface{}) int
• func Vsprintf(buffer, format []byte, varList ...interface{}) int
• type DivT
  • func Div(numer, denom int) DivT
• type File
  • func Fopen(filePath, mode []byte) *File
  • func NewFile(f *os.File) *File
  • func Tmpfile() *File
• type LdivT
  • func Ldiv(numer, denom int32) LdivT
• type LldivT
  • func Lldiv(numer, denom int64) LldivT
• type TimeT
  • func IntToTimeT(t int32) TimeT
  • func Mktime(tm []Tm) TimeT
  • func NullToTimeT(i int32) []TimeT
  • func Time(tloc []TimeT) TimeT
• type Tm
  • func Gmtime(timer []TimeT) (tm []Tm)
  • func LocalTime(timer []TimeT) (tm []Tm)

Variables

var (
	Stdin  = NewFile(os.Stdin)
	Stdout = NewFile(os.Stdout)
	Stderr = NewFile(os.Stderr)
)

Programs generated by c2go will reference noarch.Stdin instead of os.Stdin directly so that under test these can be replaced. This is required because "go test" does not redirect the stdin to the executable it is testing.

Functions

func Abs

func Abs(n int) int

Abs returns the absolute value of parameter n.

In C++, this function is also overloaded in header <cmath> for floating-point types (see cmath abs), in header <complex> for complex numbers (see complex abs), and in header <valarray> for valarrays (see valarray abs).

func Asctime

func Asctime(tm []Tm) []byte

Asctime - Convert tm structure to string

func Atof

func Atof(str []byte) float64

Atof parses the C string str, interpreting its content as a floating point number and returns its value as a double.

The function first discards as many whitespace characters (as in isspace) as necessary until the first non-whitespace character is found. Then, starting from this character, takes as many characters as possible that are valid following a syntax resembling that of floating point literals (see below), and interprets them as a numerical value. The rest of the string after the last valid character is ignored and has no effect on the behavior of this function.

C90 (C++98): A valid floating point number for atof using the "C" locale is formed by an optional sign character (+ or -), followed by a sequence of digits, optionally containing a decimal-point character (.), optionally followed by an exponent part (an e or E character followed by an optional sign and a sequence of digits).

C99/C11 (C++11): A valid floating point number for atof using the "C" locale is formed by an optional sign character (+ or -), followed by one of:

• A sequence of digits, optionally containing a decimal-point character (.), optionally followed by an exponent part (an e or E character followed by an optional sign and a sequence of digits).
• A 0x or 0X prefix, then a sequence of hexadecimal digits (as in isxdigit) optionally containing a period which separates the whole and fractional number parts. Optionally followed by a power of 2 exponent (a p or P character followed by an optional sign and a sequence of hexadecimal digits).
• INF or INFINITY (ignoring case).
• NAN or NANsequence (ignoring case), where sequence is a sequence of characters, where each character is either an alphanumeric character (as in isalnum) or the underscore character (_).

If the first sequence of non-whitespace characters in str does not form a valid floating-point number as just defined, or if no such sequence exists because either str is empty or contains only whitespace characters, no conversion is performed and the function returns 0.0.

func Atoi

func Atoi(str []byte) int

Atoi parses the C-string str interpreting its content as an integral number, which is returned as a value of type int.

The function first discards as many whitespace characters (as in isspace) as necessary until the first non-whitespace character is found. Then, starting from this character, takes an optional initial plus or minus sign followed by as many base-10 digits as possible, and interprets them as a numerical value.

The string can contain additional characters after those that form the integral number, which are ignored and have no effect on the behavior of this function.

If the first sequence of non-whitespace characters in str is not a valid integral number, or if no such sequence exists because either str is empty or it contains only whitespace characters, no conversion is performed and zero is returned.

func Atol

func Atol(str []byte) int32

Atol parses the C-string str interpreting its content as an integral number, which is returned as a value of C type "long int".

The function first discards as many whitespace characters (as in isspace) as necessary until the first non-whitespace character is found. Then, starting from this character, takes an optional initial plus or minus sign followed by as many base-10 digits as possible, and interprets them as a numerical value.

The string can contain additional characters after those that form the integral number, which are ignored and have no effect on the behavior of this function.

If the first sequence of non-whitespace characters in str is not a valid integral number, or if no such sequence exists because either str is empty or it contains only whitespace characters, no conversion is performed and zero is returned.

func Atoll

func Atoll(str []byte) int64

Atoll parses the C-string str interpreting its content as an integral number, which is returned as a value of C type long long int.

This function operates like atol to interpret the string, but produces numbers of type long long int (see atol for details on the interpretation process).

func BoolToInt

func BoolToInt(x bool) int

BoolToInt converts boolean value to an int, which is a common operation in C. 0 and 1 represent false and true respectively.

func CPointerToGoPointer

func CPointerToGoPointer(a interface{}) interface{}

CPointerToGoPointer converts a C-style pointer into a Go-style pointer.

C pointers are represented as slices that have one element pointing to where the original C pointer would be referencing. This isn't useful if the pointed value needs to be passed to another Go function in these libraries.

See also GoPointerToCPointer.

func CStringIsNull

func CStringIsNull(s []byte) bool

CStringIsNull will test if a C string is NULL. This is equivalent to:

s == NULL

func CStringToString

func CStringToString(s []byte) string

CStringToString returns a string that contains all the bytes in the provided C string up until the first NULL character.

func Ctime

func Ctime(tloc []TimeT) []byte

Ctime converts TimeT to a string.

func Fclose

func Fclose(f *File) int

Fclose handles fclose().

Closes the file associated with the stream and disassociates it.

All internal buffers associated with the stream are disassociated from it and flushed: the content of any unwritten output buffer is written and the content of any unread input buffer is discarded.

Even if the call fails, the stream passed as parameter will no longer be associated with the file nor its buffers.

func Feof

func Feof(stream *File) int

Feof handles feof().

Checks whether the end-of-File indicator associated with stream is set, returning a value different from zero if it is.

This indicator is generally set by a previous operation on the stream that attempted to read at or past the end-of-file.

Notice that stream's internal position indicator may point to the end-of-file for the next operation, but still, the end-of-file indicator may not be set until an operation attempts to read at that point.

This indicator is cleared by a call to clearerr, rewind, fseek, fsetpos or freopen. Although if the position indicator is not repositioned by such a call, the next i/o operation is likely to set the indicator again.

func Fflush

func Fflush(stream *File) int

Fflush handles fflush().

If the given stream was open for writing (or if it was open for updating and the last i/o operation was an output operation) any unwritten data in its output buffer is written to the file.

If stream is a null pointer, all such streams should be flushed, but this is currently not supported.

The stream remains open after this call.

When a file is closed, either because of a call to fclose or because the program terminates, all the buffers associated with it are automatically flushed.

func Fgetc

func Fgetc(stream *File) int

Fgetc handles fgetc().

Returns the character currently pointed by the internal file position indicator of the specified stream. The internal file position indicator is then advanced to the next character.

If the stream is at the end-of-file when called, the function returns EOF and sets the end-of-file indicator for the stream (feof).

If a read error occurs, the function returns EOF and sets the error indicator for the stream (ferror).

fgetc and getc are equivalent, except that getc may be implemented as a macro in some libraries.

func Fgetpos

func Fgetpos(f *File, pos []int) int

Fgetpos handles fgetpos().

Retrieves the current position in the stream.

The function fills the fpos_t object pointed by pos with the information needed from the stream's position indicator to restore the stream to its current position (and multibyte state, if wide-oriented) with a call to fsetpos.

The ftell function can be used to retrieve the current position in the stream as an integer value.

func Fgets

func Fgets(str []byte, num int, stream *File) []byte

Fgets handles fgets().

Reads characters from stream and stores them as a C string into str until (num-1) characters have been read or either a newline or the end-of-file is reached, whichever happens first.

A newline character makes fgets stop reading, but it is considered a valid character by the function and included in the string copied to str.

A terminating null character is automatically appended after the characters copied to str.

Notice that fgets is quite different from gets: not only fgets accepts a stream argument, but also allows to specify the maximum size of str and includes in the string any ending newline character.

func Fprintf

func Fprintf(f *File, format []byte, args ...interface{}) int

Fprintf handles fprintf().

Writes the C string pointed by format to the stream. If format includes format specifiers (subsequences beginning with %), the additional arguments following format are formatted and inserted in the resulting string replacing their respective specifiers.

After the format parameter, the function expects at least as many additional arguments as specified by format.

func Fputc

func Fputc(c int, f *File) int

Fputc handles fputc().

Writes a character to the stream and advances the position indicator.

The character is written at the position indicated by the internal position indicator of the stream, which is then automatically advanced by one.

func Fputs

func Fputs(str []byte, stream *File) int

Fputs handles fputs().

Writes the C string pointed by str to the stream.

The function begins copying from the address specified (str) until it reaches the terminating null character ('\0'). This terminating null-character is not copied to the stream.

Notice that fputs not only differs from puts in that the destination stream can be specified, but also fputs does not write additional characters, while puts appends a newline character at the end automatically.

func Fread

func Fread(ptr *[]byte, size1, size2 int, f *File) int

Fread handles fread().

Reads an array of count elements, each one with a size of size bytes, from the stream and stores them in the block of memory specified by ptr.

The position indicator of the stream is advanced by the total amount of bytes read.

The total amount of bytes read if successful is (size*count).

func Free

func Free(anything interface{})

Free doesn't do anything since memory is managed by the Go garbage collector. However, I will leave it here as a placeholder for now.

func Fscanf

func Fscanf(f *File, format []byte, args ...interface{}) int

Fscanf handles fscanf().

Reads data from the stream and stores them according to the parameter format into the locations pointed by the additional arguments.

The additional arguments should point to already allocated objects of the type specified by their corresponding format specifier within the format string.

func Fseek

func Fseek(f *File, offset int32, origin int) int

Fseek handles fseek().

Sets the position indicator associated with the stream to a new position.

For streams open in binary mode, the new position is defined by adding offset to a reference position specified by origin.

For streams open in text mode, offset shall either be zero or a value returned by a previous call to ftell, and origin shall necessarily be SEEK_SET.

If the function is called with other values for these arguments, support depends on the particular system and library implementation (non-portable).

The end-of-file internal indicator of the stream is cleared after a successful call to this function, and all effects from previous calls to ungetc on this stream are dropped.

On streams open for update (read+write), a call to fseek allows to switch between reading and writing.

func Fsetpos

func Fsetpos(stream *File, pos []int) int

Fsetpos handles fsetpos().

Restores the current position in the stream to pos.

The internal file position indicator associated with stream is set to the position represented by pos, which is a pointer to an fpos_t object whose value shall have been previously obtained by a call to fgetpos.

The end-of-file internal indicator of the stream is cleared after a successful call to this function, and all effects from previous calls to ungetc on this stream are dropped.

On streams open for update (read+write), a call to fsetpos allows to switch between reading and writing.

A similar function, fseek, can be used to set arbitrary positions on streams open in binary mode.

func Ftell

func Ftell(f *File) int32

Ftell handles ftell().

Returns the current value of the position indicator of the stream.

For binary streams, this is the number of bytes from the beginning of the file.

For text streams, the numerical value may not be meaningful but can still be used to restore the position to the same position later using fseek (if there are characters put back using ungetc still pending of being read, the behavior is undefined).

func Fwrite

func Fwrite(str []byte, size1, size2 int, stream *File) int

Fwrite handles fwrite().

Writes an array of count elements, each one with a size of size bytes, from the block of memory pointed by ptr to the current position in the stream.

The position indicator of the stream is advanced by the total number of bytes written.

Internally, the function interprets the block pointed by ptr as if it was an array of (size*count) elements of type unsigned char, and writes them sequentially to stream as if fputc was called for each byte.

func Getchar

func Getchar() int

Getchar handles getchar().

Returns the next character from the standard input (stdin).

It is equivalent to calling getc with stdin as argument.

func Getenv

func Getenv(name []byte) []byte

Getenv retrieves a C-string containing the value of the environment variable whose name is specified as argument. If the requested variable is not part of the environment list, the function returns a null pointer.

The pointer returned points to an internal memory block, whose content or validity may be altered by further calls to getenv (but not by other library functions).

The string pointed by the pointer returned by this function shall not be modified by the program. Some systems and library implementations may allow to change environmental variables with specific functions (putenv, setenv...), but such functionality is non-portable.

func GoPointerToCPointer

func GoPointerToCPointer(destination interface{}, value interface{})

GoPointerToCPointer does the opposite of CPointerToGoPointer.

A Go pointer (simply a pointer) is converted back into the original slice structure (of the original slice reference) so that the calling functions will be able to see the new data of that pointer.

func IsNaN

func IsNaN(x float64) int

func Labs

func Labs(n int32) int32

Labs returns the absolute value of parameter n ( /n/ ).

This is the long int version of abs.

func Llabs

func Llabs(n int64) int64

Llabs returns the absolute value of parameter n ( /n/ ).

This is the long long int version of abs.

func NotInt

func NotInt(x int) int

NotInt performs a logical not (!) on an integer and returns an integer.

func NotUint16

func NotUint16(x uint16) uint16

NotUint16 works the same as NotInt, but on a uint16.

func Printf

func Printf(format []byte, args ...interface{}) int

Printf handles printf().

Writes the C string pointed by format to the standard output (stdout). If format includes format specifiers (subsequences beginning with %), the additional arguments following format are formatted and inserted in the resulting string replacing their respective specifiers.

func Putchar

func Putchar(character int)

Putchar handles putchar().

Writes a character to the standard output (stdout).

It is equivalent to calling putc with stdout as second argument.

func Puts

func Puts(str []byte) int

Puts handles puts().

Writes the C string pointed by str to the standard output (stdout) and appends a newline character ('\n').

The function begins copying from the address specified (str) until it reaches the terminating null character ('\0'). This terminating null-character is not copied to the stream.

Notice that puts not only differs from fputs in that it uses stdout as destination, but it also appends a newline character at the end automatically (which fputs does not).

func Remove

func Remove(filePath []byte) int

Remove handles remove().

Deletes the file whose name is specified in filePath.

This is an operation performed directly on a file identified by its filePath; No streams are involved in the operation.

Proper file access shall be available.

func Rename

func Rename(oldName, newName []byte) int

Rename handles rename().

Changes the name of the file or directory specified by oldName to newName.

This is an operation performed directly on a file; No streams are involved in the operation.

If oldName and newName specify different paths and this is supported by the system, the file is moved to the new location.

If newName names an existing file, the function may either fail or override the existing file, depending on the specific system and library implementation.

Proper file access shall be available.

func Rewind

func Rewind(stream *File)

Rewind handles rewind().

Sets the position indicator associated with stream to the beginning of the file.

The end-of-file and error internal indicators associated to the stream are cleared after a successful call to this function, and all effects from previous calls to ungetc on this stream are dropped.

On streams open for update (read+write), a call to rewind allows to switch between reading and writing.

func Scanf

func Scanf(format []byte, args ...interface{}) int

Scanf handles scanf().

Reads data from stdin and stores them according to the parameter format into the locations pointed by the additional arguments.

The additional arguments should point to already allocated objects of the type specified by their corresponding format specifier within the format string.

func Signbitd

func Signbitd(x float64) int

func Signbitf

func Signbitf(x float32) int

func Signbitl

func Signbitl(x float64) int

func Snprintf

func Snprintf(buffer []byte, n int, format []byte, args ...interface{}) int

Snprintf handles snprintf().

Writes the C string pointed by format to the standard output (stdout). If format includes format specifiers (subsequences beginning with %), the additional arguments following format are formatted and inserted in the resulting string replacing their respective specifiers.

func Sprintf

func Sprintf(buffer, format []byte, args ...interface{}) int

Sprintf handles sprintf().

Writes the C string pointed by format to the standard output (stdout). If format includes format specifiers (subsequences beginning with %), the additional arguments following format are formatted and inserted in the resulting string replacing their respective specifiers.

func Strcat

func Strcat(dest, src []byte) []byte

Strcat - concatenate strings Appends a copy of the source string to the destination string. The terminating null character in destination is overwritten by the first character of source, and a null-character is included at the end of the new string formed by the concatenation of both in destination.

func Strchr

func Strchr(str []byte, ch int) []byte

Strchr - Locate first occurrence of character in string See: http://www.cplusplus.com/reference/cstring/strchr/

func Strcmp

func Strcmp(str1, str2 []byte) int

Strcmp - compare two strings Compares the C string str1 to the C string str2.

func Strcpy

func Strcpy(dest, src []byte) []byte

Strcpy copies the C string pointed by source into the array pointed by destination, including the terminating null character (and stopping at that point).

To avoid overflows, the size of the array pointed by destination shall be long enough to contain the same C string as source (including the terminating null character), and should not overlap in memory with source.

func StringToCString

func StringToCString(s string) []byte

StringToCString returns the C string (also known as a null terminated string) to be as used as a string in C.

func Strlen

func Strlen(a []byte) int

Strlen returns the length of a string.

The length of a C string is determined by the terminating null-character: A C string is as long as the number of characters between the beginning of the string and the terminating null character (without including the terminating null character itself).

func Strncpy

func Strncpy(dest, src []byte, len int) []byte

Strncpy copies the first num characters of source to destination. If the end of the source C string (which is signaled by a null-character) is found before num characters have been copied, destination is padded with zeros until a total of num characters have been written to it.

No null-character is implicitly appended at the end of destination if source is longer than num. Thus, in this case, destination shall not be considered a null terminated C string (reading it as such would overflow).

destination and source shall not overlap (see memmove for a safer alternative when overlapping).

func Strtod

func Strtod(str []byte, endptr [][]byte) float64

Strtod parses the C-string str interpreting its content as a floating point number (according to the current locale) and returns its value as a double. If endptr is not a null pointer, the function also sets the value of endptr to point to the first character after the number.

The function first discards as many whitespace characters (as in isspace) as necessary until the first non-whitespace character is found. Then, starting from this character, takes as many characters as possible that are valid following a syntax resembling that of floating point literals (see below), and interprets them as a numerical value. A pointer to the rest of the string after the last valid character is stored in the object pointed by endptr.

func Strtof

func Strtof(str []byte, endptr [][]byte) float32

Strtof works the same way as Strtod but returns a float.

func Strtol

func Strtol(str []byte, endptr [][]byte, radix int) int32

Strtol parses the C-string str interpreting its content as an integral number of the specified base, which is returned as a long int value. If endptr is not a null pointer, the function also sets the value of endptr to point to the first character after the number.

The function first discards as many whitespace characters as necessary until the first non-whitespace character is found. Then, starting from this character, takes as many characters as possible that are valid following a syntax that depends on the base parameter, and interprets them as a numerical value. Finally, a pointer to the first character following the integer representation in str is stored in the object pointed by endptr.

If the value of base is zero, the syntax expected is similar to that of integer constants, which is formed by a succession of:

• An optional sign character (+ or -)
• An optional prefix indicating octal or hexadecimal base ("0" or "0x"/"0X" respectively)

A sequence of decimal digits (if no base prefix was specified) or either octal or hexadecimal digits if a specific prefix is present

If the base value is between 2 and 36, the format expected for the integral number is a succession of any of the valid digits and/or letters needed to represent integers of the specified radix (starting from '0' and up to 'z'/'Z' for radix 36). The sequence may optionally be preceded by a sign (either + or -) and, if base is 16, an optional "0x" or "0X" prefix.

If the first sequence of non-whitespace characters in str is not a valid integral number as defined above, or if no such sequence exists because either str is empty or it contains only whitespace characters, no conversion is performed.

For locales other than the "C" locale, additional subject sequence forms may be accepted.

func Strtold

func Strtold(str []byte, endptr [][]byte) float64

Strtold works the same way as Strtod but returns a long double.

func Strtoll

func Strtoll(str []byte, endptr [][]byte, radix int) int64

Strtoll works the same way as Strtol but returns a long long.

func Strtoul

func Strtoul(str []byte, endptr [][]byte, radix int) uint32

Strtoul works the same way as Strtol but returns a long unsigned int.

func Strtoull

func Strtoull(str []byte, endptr [][]byte, radix int) uint64

Strtoull works the same way as Strtol but returns a long long unsigned int.

func Ternary

func Ternary(a bool, b, c func() interface{}) interface{}

Ternary simulates the ternary (also known as the conditional operator). Go does not have the equivalent of using if statements as expressions or inline if statements. This function takes the true and false parts as closures to be sure that only the true or false condition is evaulated - to prevent side effects.

func TimeTToFloat64

func TimeTToFloat64(t TimeT) float64

TimeTToFloat64 converts TimeT to a float64. It is used by the tests.

func Tmpnam

func Tmpnam(str []byte) []byte

Tmpnam handles tmpnam().

Returns a string containing a file name different from the name of any existing file, and thus suitable to safely create a temporary file without risking to overwrite an existing file.

If str is a null pointer, the resulting string is stored in an internal static array that can be accessed by the return value. The content of this string is preserved at least until a subsequent call to this same function, which may overwrite it.

If str is not a null pointer, it shall point to an array of at least L_tmpnam characters that will be filled with the proposed temporary file name.

The file name returned by this function can be used to create a regular file using fopen to be used as a temporary file. The file created this way, unlike those created with tmpfile is not automatically deleted when closed; A program shall call remove to delete this file once closed.

func Vsnprintf

func Vsnprintf(buffer []byte, n int, format []byte, varList ...interface{}) int

Vsnprintf handles vsnprintf().

Writes the C string pointed by format to the standard output (stdout). If format includes format specifiers (subsequences beginning with %), the additional arguments following format are formatted and inserted in the resulting string replacing their respective specifiers.

func Vsprintf

func Vsprintf(buffer, format []byte, varList ...interface{}) int

Vsprintf handles vsprintf().

Writes the C string pointed by format to the standard output (stdout). If format includes format specifiers (subsequences beginning with %), the additional arguments following format are formatted and inserted in the resulting string replacing their respective specifiers.

Types

type DivT

type DivT struct {
	Quot int // quotient
	Rem  int // remainder
}

DivT is the representation of "div_t". It is used by div().

func Div

func Div(numer, denom int) DivT

Div returns the integral quotient and remainder of the division of numer by denom ( numer/denom ) as a structure of type div_t, ldiv_t or lldiv_t, which has two members: quot and rem.

type File

type File struct {
	// This is not part of the original struct but it is needed for internal
	// calls in Go.
	OsFile *os.File
}

File represents the definition has been translated from the original definition for __sFILE, which is an alias for FILE. Not all of the attributes have been translated. They should be turned on as needed.

func Fopen

func Fopen(filePath, mode []byte) *File

Fopen handles fopen().

Opens the file whose name is specified in the parameter filePath and associates it with a stream that can be identified in future operations by the File pointer returned.

The operations that are allowed on the stream and how these are performed are defined by the mode parameter.

The returned pointer can be disassociated from the file by calling fclose() or freopen(). All opened files are automatically closed on normal program termination.

func NewFile

func NewFile(f *os.File) *File

NewFile creates a File pointer from a Go file pointer.

func Tmpfile

func Tmpfile() *File

Tmpfile handles tmpfile().

Creates a temporary binary file, open for update ("wb+" mode, see fopen for details) with a filename guaranteed to be different from any other existing file.

The temporary file created is automatically deleted when the stream is closed (fclose) or when the program terminates normally. If the program terminates abnormally, whether the file is deleted depends on the specific system and library implementation.

type LdivT

type LdivT struct {
	Quot int32 // quotient
	Rem  int32 // remainder
}

LdivT is the representation of "ldiv_t". It is used by ldiv().

func Ldiv

func Ldiv(numer, denom int32) LdivT

Ldiv returns the integral quotient and remainder of the division of numer by denom ( numer/denom ) as a structure of type ldiv_t, which has two members: quot and rem.

type LldivT

type LldivT struct {
	Quot int64 // quotient
	Rem  int64 // remainder
}

LldivT is the representation of "lldiv_t". It is used by lldiv().

func Lldiv

func Lldiv(numer, denom int64) LldivT

Lldiv returns the integral quotient and remainder of the division of numer by denom ( numer/denom ) as a structure of type lldiv_t, which has two members: quot and rem.

type TimeT

type TimeT int32

TimeT is the representation of "time_t". For historical reasons, it is generally implemented as an integral value representing the number of seconds elapsed since 00:00 hours, Jan 1, 1970 UTC (i.e., a unix timestamp). Although libraries may implement this type using alternative time representations.

func IntToTimeT

func IntToTimeT(t int32) TimeT

IntToTimeT converts an int32 to a TimeT.

func Mktime

func Mktime(tm []Tm) TimeT

Mktime - Convert tm structure to time_t Returns the value of type time_t that represents the local time described by the tm structure pointed by timeptr (which may be modified).

func NullToTimeT

func NullToTimeT(i int32) []TimeT

NullToTimeT converts a NULL to an array of TimeT.

func Time

func Time(tloc []TimeT) TimeT

Time returns the current time.

type Tm

type Tm struct {
	Tm_sec   int
	Tm_min   int
	Tm_hour  int
	Tm_mday  int
	Tm_mon   int
	Tm_year  int
	Tm_wday  int
	Tm_yday  int
	Tm_isdst int
}

Tm - base struct in "time.h" Structure containing a calendar date and time broken down into its components

func Gmtime

func Gmtime(timer []TimeT) (tm []Tm)

Gmtime - Convert time_t to tm as UTC time

func LocalTime

func LocalTime(timer []TimeT) (tm []Tm)

Localtime - Convert time_t to tm as local time Uses the value pointed by timer to fill a tm structure with the values that represent the corresponding time, expressed for the local timezone.