compiler/clib/stpblk.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Supplemental C function stpblk().
   6 */
   7
   8 #include <ctype.h>
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <string.h>
  14
  15         char * stpblk (
  16
  17 /*  SYNOPSIS */
  18         const char * str )
  19
  20 /*  FUNCTION
  21         Searches for the first non-blank character in a string. A blank
  22         character is defined as one that isspace() treats like one
  23         (ie. spaces, tabs and newlines).
  24
  25     INPUTS
  26         str - String to search.
  27
  28     RESULT
  29         A pointer to the first occurence of a non-blank character in str.
  30
  31     NOTES
  32         This function always returns a valid pointer as provided str isn't
  33         NULL. If there are no non-blank characters in the string, a pointer
  34         to the trailing '\0' is returned (ie. an empty string).
  35
  36     EXAMPLE
  37         char *hello = " Hello";
  38         char *empty = "      ";
  39
  40         printf( stpblk( hello ) );
  41         --> Hello
  42
  43         printf( stpblk( empty ) );
  44         -->
  45
  46         printf( "%d", strlen( stpblk( hello ) ) );
  47         --> 5
  48
  49         printf( "%d", strlen( stpblk( empty ) ) );
  50         --> 0
  51
  52     BUGS
  53
  54     SEE ALSO
  55         isspace()
  56
  57     INTERNALS
  58
  59 ******************************************************************************/
  60 {
  61     if( str == NULL ) return NULL;
  62
  63     while( *str != '\0' && isspace( *str ) )
  64     {
  65         str++;
  66     }
  67
  68     return (char *)str;
  69 } /* stpblk */