.\" (C) 2002 Ian Gulliver
.TH firestring_estr_chug 3 2003-07-30
.SH NAME
firestring_estr_chug \-
remove whitespace from the beginning of an estring
.SH SYNOPSIS
.B #include <firestring.h>
.br
.B -lfirestring
.LP
.BI "void firestring_estr_chug(struct firestring_estr_t *" "string" ")"
.SH DESCRIPTION
firestring_estr_chug shortens
.I string
by moving the start forward until the string begins with a non-whitespace character or is empty.
.SH CAVEATS
This function moves the starting pointer inside
.IR string .
If
.I string
was allocated with
.IR firestring_estr_alloc (3),
(as opposed to constructed manually pointing inside other memory), future calls to
.IR firestring_estr_free (3)
will fail if this function trimmed any space from the start of the string.  In these cases, use
.IR firestring_estr_ip_chug (3)
instead.
.SH RETURN VALUE
None.
.SH AUTHOR
Ian Gulliver <ian@penguinhosting.net>
.SH SEE ALSO
.BR libfirestring (3)