Section 3: library functions
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 Sorry! ", ustrerror(errno)); Return Value Returns a…
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[]);…
usprintf – Writes formatted data into a buffer. Allegro game programming library. Synopsis #include <allegro.h> int usprintf(char *buf, const char *format, …); Description This function writes formatted data into the output buffer. A NULL character is written to mark the end of the string. You should try to avoid this function because it is very…
usleep – suspend execution for microsecond intervals Synopsis #include <unistd.h> int usleep(useconds_t usec); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): usleep(): Since glibc 2.12: (_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200809L) || /* Glibc since 2.19: */ _DEFAULT_SOURCE || /* Glibc versions <= 2.19: */ _BSD_SOURCE Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE >= 500 Description The usleep() function suspends…
usetc – Low level helper function for writing Unicode text data. Allegro game programming library. Synopsis #include <allegro.h> int usetc(char *s, int c); Description Low level helper function for writing Unicode text data. Writes the character `c’ to the address pointed to by `s’. Return Value Returns the number of bytes written, which is equal…
usetat – Replaces a character in a string. Allegro game programming library. Synopsis #include <allegro.h> int usetat(char *s, int index, int c); Description Replaces the character at the specified index in the string with value `c’, handling any adjustments for variable width data (ie. if `c’ encodes to a different width than the previous value…