https://invisible-island.net/cdk/manpage/


cdk_misc 3 2024-03-28 Library calls

cdk_misc(3)                     Library calls                    cdk_misc(3)

NAME

       cdk_misc - Cdk miscellaneous routines

SYNOPSIS

       cc [ flag ... ] file ...  -lcdk [ library ... ]

       #include <cdk.h>

       void Beep(void);

       unsigned CDKallocStrings(
                      char ***list/,
                      char *item/,
                      unsigned length/,
                      unsigned used/);

       unsigned CDKcountStrings (
                      CDK_CONST char **list);

       void CDKfreeChtypes(
                      chtype **list);

       void CDKfreeStrings (
                      char **list);

       char ** CDKsplitString (
                      const char *string,
                      int splitChar);

       char * baseName (
                      char *string);

       int ceilCDK(   doublevalue);

       int chlen (    const chtype *string);

       void chstrncpy(
                      char *dest,
                      const chtype *src,
                      int maxcount);

       char *chtype2Char (
                      const chtype *string);

       void cleanChar (
                      char *string,
                      int length,
                      char character);

       void cleanChtype (
                      chtype *string,
                      int length,
                      chtype character);

       int cmpStrChstr(
                      const char *str,
                      const chtype *chstr);

       char *copyChar (
                      const char *string);

       char **copyCharList (
                      const char **list);

       chtype *copyChtype (
                      const chtype *string);

       chtype **copyChtypeList (
                      const chtype **list);

       char *dirName (
                      char *filename);

       int floorCDK(  double value);

       void freeChar (
                      char *string);

       void freeCharList (
                      char **list,
                      unsigned size);

       void freeChtype (
                      chtype *string);

       void freeChtypeList ("
                      chtype **list,
                      unsigned size);

       int intlen (   int value);

       int lenCharList (
                      const char **list);

       int lenChtypeList (
                      const chtype **list);

       int mode2Char (
                      char *string,
                      mode_t fileMode);

       int searchList (
                      CDK_CONST char * CDK_CONST *list,
                      int listSize,
                      const char *pattern);

       void sortList (
                      CDK_CONST char **list,
                      int length);

DESCRIPTION

       These  are  miscellaneous  functions which may be useful with the Cdk
       widget set.

AVAILABLE FUNCTIONS

       Beep makes an audible beep.  The  standard  curses  beep()  does  not
            flush  the  stream,  so it will only beep until a force is made.
            This forces a flush after issuing the beep command.

       CDKallocStrings
            Add a new string item to a list.  Keep a null pointer on the end
            so  one  may  use CDKfreeStrings() to deallocate the whole list.
            The caller is responsible for updating the length of  the  list.
            The return value is the updated number of chars used.

       CDKcountStrings
            Count the number of items in a null-terminated list of character
            strings.  Return the count.

       CDKfreeChtypes
            Free a list of chtype-strings which  is  terminated  by  a  null
            pointer.

       CDKfreeStrings
            Free  a  list of character strings which is terminated by a null
            pointer.  Also free list itself.

       CDKsplitString
            split the string at each occurrence of  separator,  returning  a
            pointer  to  a  dynamically  allocated array of the pieces.  The
            original string is unmodified.  The caller  is  responsible  for
            freeing the result.

       baseName
            returns  a pointer to the first character of the filename in the
            given pathname.  The result should be freed by the caller.

       ceilCDK
            Return an integer like the math library ceil(), which returns  a
            double.

       chlen
            returns the length of the (null-terminated) string of chtype's.

       chstrncpy
            Extract  the characters from a null-terminated array of chtype's
            src.  The size of the destination dest is given in maxcount.

       chtype2Char
            Extract the characters from a null-terminated array of  chtype's
            string.  A dynamically allocated string is returned.  The caller
            is responsible for freeing the result.

       cleanChar
            is analogous to memset.  Set the characters  in  string  to  the
            given  character.   The  length  of  string  is given by length.
            character which will be written.

       cleanChtype
            is analogous to memset.  Set the chtype's in string to the given
            character.  The length of string is given by length.

       cmpStrChstr
            Compare  a char string str to a chtype string chstr.  Return -1,
            0 or 1 according to whether  str  is  less  than,  equal  to  to
            greater than chstr.

       copyChar
            copies  the  string passed in.  Unlike strdup this checks to see
            if the string is NULL before copying.

       copyCharList
            copies the given list.

       copyChtype
            function copies the string passed in, analogous to copyChar, but
            for chtype strings.

       copyChtypeList
            copies the given list.

       dirName
            Returns the directory for the given filename, i.e., the part be-
            fore the * last slash.  The return value should be freed by  the
            caller.

       floorCDK
            Return  an integer like the math function floor(), which returns
            a double.

       freeChar
            is a wrapper for free.  It checks to see if the string  is  NULL
            before trying to free the string.

       freeCharList
            Free  the  memory used by the given list of strings.  The number
            of strings to free is given by size.

       freeChtype
            is a wrapper for free, like freeChar.

       freeChtypeList
            Free the memory used by the given list of chtype  strings.   The
            number of strings to free is given by size.

       intlen
            returns the length of an integer, i.e., the number of characters
            needed to represent it.

       lenCharList
            returns the length of the given list.

       lenChtypeList
            returns the length of the given list.

       mode2Char
            Given a file protection mode fileMode, store a printable version
            of  the permissions in string, formatted as if by "ls -l").  Re-
            turn the corresponding  permissions  data,  i.e.,  ignoring  the
            file-type bits.

       searchList
            Search the given list of listSize strings for a subset of a word
            pattern in the given list.  Return the index in the list  if  it
            is found, or -1 if not found.

       sortList
            performs  a quick sort of the given list.  This is a wrapper for
            qsort, used to sort the list of strings.  The number of  strings
            in  list  is given by length.  The list is sorted alphabetically
            in increasing order.

SEE ALSO

       cdk(3), cdk_screen(3), cdk_display(3), cdk_binding(3), cdk_util(3)

                                 2024-03-28                      cdk_misc(3)