The Linux Manuals (man pages) document is an important part of Linux documents. Linux Manuals are organized as several sections. Each section has a group of commands for a specific area in Linux usage, administration or development.
ustrtok_r – Reentrant function to retrieve tokens from a string. Allegro game programming library. Synopsis #include <allegro.h> char *ustrtok_r(char *s, const char *set, char **last); Description Reentrant version of ustrtok. The `last’ parameter is used to keep track of where the parsing is up to and must be a pointer to a char * variable…
ustrtok – Retrieves tokens from a string. Allegro game programming library. Synopsis #include <allegro.h> char *ustrtok(char *s, const char *set); Description This function retrieves tokens from `s’ which are delimited by characters from `set’. To initiate the search, pass the string to be searched as `s’. For the remaining tokens, pass NULL instead. Warning: Since…
ustrtod – Converts a string into a floating point number. Allegro game programming library. Synopsis #include <allegro.h> double ustrtod(const char *s, char **endp); Description This function converts as many characters of `s’ that look like a floating point number into one, and sets `*endp’ to point to the first unused character, if `endp’ is not…
ustrstr – Finds the first occurrence of a string in another one. Allegro game programming library. Synopsis #include <allegro.h> char *ustrstr(const char *s1, const char *s2); Description This function finds the first occurrence of string `s2′ in string `s1′. Example: char *p = ustrstr("hello world", "world"); Return Value Returns a pointer within `s1′, or NULL…
ustrrchr – Finds the last occurrence of a character in a string. Allegro game programming library. Synopsis #include <allegro.h> char *ustrrchr(const char *s, int c); Description Finds the last occurrence of the character `c’ in the string `s’. Example: char *p = ustrrchr("one,two,three,four", ‘,’); Return Value Returns a pointer for the last occurrence of `c’…
ustrpbrk – Finds the first character that matches any in a set. Allegro game programming library. Synopsis #include <allegro.h> char *ustrpbrk(const char *s, const char *set); Description This function finds the first character in `s’ that matches any character in `set’. Example: char *p = ustrpbrk("one,two-three.four", "-. "); Return Value Returns a pointer to the…
ustrnicmp – Compares up to n letters of two strings ignoring case. Allegro game programming library. Synopsis #include <allegro.h> int ustrnicmp(const char *s1, const char *s2, int n); Description This function compares up to `n’ characters of `s1′ and `s2′, ignoring case. Example: if (ustrnicmp(prefix, long_string, ustrlen(prefix)) == 0) { /* long_string starts with prefix…
ustrncpy – Copies a string into another one, specifying size. Allegro game programming library. Synopsis #include <allegro.h> char *ustrncpy(char *dest, const char *src, int n); Description This function is like ustrcpy() except that no more than `n’ characters from `src’ are copied into `dest’. If `src’ is shorter than `n’ characters, null characters are appended…
ustrncmp – Compares up to n letters of two strings. Allegro game programming library. Synopsis #include <allegro.h> int ustrncmp(const char *s1, const char *s2, int n); Description This function compares up to `n’ characters of `s1′ and `s2′. Example: if (ustrncmp(prefix, long_string, ustrlen(prefix)) == 0) { /* long_string starts with prefix */ } Return Value…
ustrncat – Concatenates a string to another one, specifying size. Allegro game programming library. Synopsis #include <allegro.h> char *ustrncat(char *dest, const char *src, int n); Description This function is like ustrcat() except that no more than `n’ characters from `src’ are appended to the end of `dest’. If the terminating null character in `src’ is…
ustrlwr – Replaces all letters with lower case. Allegro game programming library. Synopsis #include <allegro.h> char *ustrlwr(char *s); Description This function replaces all upper case letters in `s’ with lower case letters. Example: char buffer[] = "UPPER CASE STRING"; allegro_message(ustrlwr(buffer)); Return Value The return value is the value of `s’. See Also uconvert(3), utolower(3), ustrupr(3)
ustricmp – Compares two strings ignoring case. Allegro game programming library. Synopsis #include <allegro.h> int ustricmp(const char *s1, const char *s2); Description This function compares `s1′ and `s2′, ignoring case. Example: if (ustricmp(string, user_input) == 0) { /* string and user_input are equal (ignoring case) */ } Return Value Returns zero if the strings are…
ustrerror – Returns a string describing errno. Allegro game programming library. Synopsis #include <allegro.h> const char *ustrerror(int err); Description This function returns a string that describes the error code `err’, which normally comes from the variable `errno’. Example: PACKFILE *input_file = pack_fopen("badname", "r"); if (input_file == NULL) allegro_message("%s\nSorry!\n", ustrerror(errno)); Return Value Returns a pointer to…
ustrdup – Duplicates a string. Allegro game programming library. Synopsis #include <allegro.h> char *ustrdup(const char *src) Description This functions copies the null-terminated string `src’ into a newly allocated area of memory, effectively duplicating it. Example: void manipulate_string(const char *input_string) { char *temp_buffer = ustrdup(input_string); /* Now we can modify temp_buffer */ … Return Value Returns…
ustrcpy – Copies a string into another one. Allegro game programming library. Synopsis #include <allegro.h> char *ustrcpy(char *dest, const char *src); Description This function copies `src’ (including the terminating null character into `dest’. You should try to avoid this function because it is very easy to overflow the destination buffer. Use ustrzcpy instead. Return Value…
ustrcmp – Compares two strings. Allegro game programming library. Synopsis #include <allegro.h> int ustrcmp(const char *s1, const char *s2); Description This function compares `s1′ and `s2′. Return Value Returns zero if the strings are equal, a positive number if `s1′ comes after `s2′ in the ASCII collating sequence, else a negative number. See Also uconvert(3),…
ustrchr – Finds the first occurrence of a character in a string. Allegro game programming library. Synopsis #include <allegro.h> char *ustrchr(const char *s, int c); Description Finds the first occurrence of the character `c’ in the string `s’. Example: char *p = ustrchr("one,two,three,four", ‘,’); Return Value Returns a pointer to the first occurrence of `c’…
ustrcat – Concatenates a string to another one. Allegro game programming library. Synopsis #include <allegro.h> char *ustrcat(char *dest, const char *src); Description This function concatenates `src’ to the end of `dest`’. You should try to avoid this function because it is very easy to overflow the destination buffer, use ustrzcat instead. Return Value Returns the…
ustr_const – ustr string library constants Synopsis #include "ustr.h" USTR_CONF_INCLUDE_CODEONLY_HEADERS USTR_CONF_USE_EOS_MARK USTR_CONF_USE_ASSERT USTR_CONF_COMPILE_USE_ATTRIBUTES USTR_CONF_COMPILE_TYPEDEF USTR_CONF_COMPILE_USE_INLINE USTR_BEG_CONST1 USTR_BEG_CONST2 USTR_BEG_CONST4 USTR_BEG_FIXED1 USTR_BEG_FIXED2 USTR_BEG_FIXED4 USTR_BEG_FIXED8 USTR_END_ALOCDx USTR_END_CONSTx USTR_END_FIXEDx USTR_FLAG_PARSE_NUM_DEF USTR_FLAG_PARSE_NUM_SEP USTR_FLAG_PARSE_NUM_OVERFLOW USTR_FLAG_PARSE_NUM_SPACE USTR_FLAG_PARSE_NUM_NO_BEG_ZERO USTR_FLAG_PARSE_NUM_NO_BEG_PM USTR_FLAG_PARSE_NUM_NO_NEGATIVE…
ustr – ustr string library functions Synopsis #include "ustr.h" struct Ustr *USTR(void *); struct Ustrp *USTRP(void *); struct Ustr *USTR1(symbol, const char[]); struct Ustr *USTR2(symbol, symbol, const char[]); struct Ustr *USTR4(symbol, symbol, symbol, symbol, const char[]); struct Ustr *USTR1_CHK(symbol, const char[]); struct Ustr *USTR2_CHK(symbol, symbol, const char[]); struct Ustr *USTR4_CHK(symbol, symbol, symbol, symbol, const char[]);…