NAME
const_trim_beg - Moves a string pointer to the next non white space
SYNOPSIS
#include "l/l_string.h"
Example compile flags (system dependent):
-DLINUX_X86_64 -DLINUX_X86_64_OPTERON -DGNU_COMPILER
-I/home/kobus/include
-L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
-lKJB -lfftw3 -lgsl -lgslcblas -ljpeg -lSVM -lstdc++ -lpthread -lSLATEC -lg2c -lacml -lacml_mv -lblas -lg2c -lncursesw
size_t const_trim_beg(const char **string_arg_ptr);
PARAMETERS
-
const char **string_arg_ptr
-
Address of string pointer.
DESCRIPTION
Destructively resets the begining of a string beyond all leading white space.
RETURNS
The number of blanks removed.
EXAMPLE
This code outputs a single line "Hello World" on stdout.
char* str = " Hello World";
char* str_pos = str;
trim_beg(&str_pos); // Get rid of the three blanks
put_line(str_pos); // Print on stdout with new line added
NOTE
This routine is the same as trim_beg(), except that the constness of
**string_arg_ptr is made explicit. If the argument is not a double pointer
to const (i.e., it is (char**)), then use the routine trim_beg(). Neither
trim_beg() or const_trim_beg() changes the characters in *string_arg_ptr.
RELATED
const_gen_trim_beg, gen_trim_beg, gen_trim_end, trim_beg, trim_end, trim_len
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Kobus Barnard
DOCUMENTER
Kobus Barnard
SEE ALSO
signed_strlen
,
trim_beg
,
trim_end
,
trim_len
,
gen_trim_beg
,
const_gen_trim_beg
,
gen_trim_end
,
extended_uc_lc
,
extended_lc_uc
,
extended_n_uc_lc
,
extended_n_lc_uc
,
extended_tolower
,
extended_toupper
,
void_strcmp
,
kjb_strcmp
,
kjb_memcmp
,
kjb_strncmp
,
kjb_ic_strcmp
,
kjb_ic_strncmp
,
head_cmp
,
ic_head_cmp
,
ptr_strcmp
,
ptr_strncmp
,
ptr_ic_strcmp
,
ptr_head_cmp
,
ptr_ic_head_cmp
,
rpad
,
rpad_cpy
,
kjb_strdup
,
str_trunc_cpy
,
str_trunc_cat
,
trunc_quote_cpy
,
kjb_buff_cpy
,
kjb_strncpy
,
kjb_memcpy
,
extended_lc_strncpy
,
extended_uc_strncpy
,
kjb_buff_cat
,
kjb_strncat
,
cap_first_letter_cpy
,
str_build
,
str_n_build
,
str_char_build
,
byte_build
,
increment_byte_copy
,
fill_with_blanks
,
find_string
,
find_char
,
n_find_char
,
find_char_pair
,
count_char
,
word_in_phrase
,
char_for_char_translate
,
remove_duplicate_chars
,
str_delete
,
str_insert
,
sget_line
,
const_sget_line
,
sget_line_2
,
const_sget_line_2
,
get_str_indent
,
last_char
,
kjb_reverse
,
output_str