char.h File Reference

Simple character manipulations. More...

#include <stdio.h>

Go to the source code of this file.

Functions
static char	hexnibbletoa (int h)
	Convert hex nibble to ascii equivalent. More...
char *	NewPrettyBuf (byte_t buf[], size_t len)
	Allocates a string buffer and copies a 'prettified' readable version of the contents of the given (binary) buffer. More...
int	PrettyPrintBuf (FILE *fp, byte_t buf[], size_t len)
	Print out 'prettified' readable version of the contents of the given (binary) buffer. More...

Detailed Description

Simple character manipulations.

Package

RoadNarrows Robotics Common Library 1

Library

librnr

File

rnr/char.h

Author

Robin Knight (robin.nosp@m..kni.nosp@m.ght@r.nosp@m.oadn.nosp@m.arrow.nosp@m.s.co.nosp@m.m)

Copyright

© 2005-2018. RoadNarrows LLC..
http://www.roadnarrows.com
All Rights Reserved

License

MIT

EULA

See the README and EULA files for any copyright and licensing information.

—

Definition in file char.h.

Function Documentation

static char hexnibbletoa ( int  h )

inlinestatic

Convert hex nibble to ascii equivalent.

Parameters

h	Hex nibble [0,15].

Definition at line 37 of file char.h.

References C_DECLS_END, NewPrettyBuf(), and PrettyPrintBuf().

Referenced by NewPrettyBuf().

{
  return (char)(h<10? '0'+h: 'a'+(h & 0x0f));
}

char* NewPrettyBuf	(	byte_t	buf[],
		size_t	len
	)

Allocates a string buffer and copies a 'prettified' readable version of the contents of the given (binary) buffer.

Parameters

buf	Buffer to prettify
len	Number of bytes in buf.

Returns

Allocated, null-terminated, prettified string. Use delete() to deallocate.

Definition at line 40 of file char.c.

References hexnibbletoa(), and NEWSTR.

Referenced by hexnibbletoa(), and PrettyPrintBuf().

{
  char  *sPretty = NEWSTR(len*4);
  char  *s;
  int   i, c;

  for(i=0, s=sPretty; i<len; ++i)
  {
    c = (int)buf[i];
    if( c == ' ' )
    {
      *s++ = ' ';
    }
    else if( isspace(c) )
    {
      *s++ = '\\';
      switch(c)
      {
        case '\f':
          *s++ = 'f';
          break;
        case '\n':
          *s++ = 'n';
          break;
        case '\r':
          *s++ = 'r';
          break;
        case '\t':
          *s++ = 't';
          break;
        case '\v':
          *s++ = 'v';
          break;
        default:
          *s++ = hexnibbletoa( (c>>4) & 0x0f );
          *s++ = hexnibbletoa( c & 0x0f );
          break;
      }
    }
    else if( isprint(c) )
    {
      *s++ = (char)c;
    }
    else
    {
      *s++ = '\\';
      *s++ = 'x';
      *s++ = hexnibbletoa( (c>>4) & 0x0f );
      *s++ = hexnibbletoa( c & 0x0f );
    }
  }
  *s = 0;
  return sPretty;
}

int PrettyPrintBuf	(	FILE *	fp,
		byte_t	buf[],
		size_t	len
	)

Print out 'prettified' readable version of the contents of the given (binary) buffer.

Parameters

fp	Output file pointer.
buf	Buffer to prettify.
len	Number of bytes in buf.

Returns

Number of characters printed.

Definition at line 107 of file char.c.

References NewPrettyBuf().

Referenced by hexnibbletoa(), and test_char().

{
  char   *sPretty;
  int     n;

  sPretty = NewPrettyBuf(buf, len);

  n = fprintf(fp, "%s", sPretty);

  delete(sPretty);

  return n;
}