Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
cdk_misc(3)		   Library Functions Manual		   cdk_misc(3)

NAME
       cdk_misc	- Curses Development Kit 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 wid-
       get 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 orig-
	    inal 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
	    before 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").	Return
	    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)

								   cdk_misc(3)

NAME | SYNOPSIS | DESCRIPTION | AVAILABLE FUNCTIONS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Beep&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help