GIS Library - Find raster map. More...

#include <string.h>
#include <stdlib.h>
#include <ctype.h>
#include <sys/types.h>
#include <grass/gis.h>

Include dependency graph for strings.c:

Macros
#define	NULL 0

Functions
int	G_strcasecmp (const char x, const char y)
	String compare ignoring case (upper or lower) More...

int	G_strncasecmp (const char x, const char y, int n)
	String compare ignoring case (upper or lower) - limited number of characters. More...

char *	G_store (const char *s)
	Copy string to allocated memory. More...

char *	G_store_upper (const char *s)
	Copy string to allocated memory and convert copied string to upper case. More...

char *	G_store_lower (const char *s)
	Copy string to allocated memory and convert copied string to lower case. More...

char *	G_strchg (char *bug, char character, char new)
	Replace all occurrences of character in string bug with new. More...

char *	G_str_replace (const char buffer, const char old_str, const char *new_str)
	Replace all occurrences of old_str in buffer with new_str. More...

void	G_strip (char *buf)
	Removes all leading and trailing white space from string. More...

char *	G_chop (char *line)
	Chop leading and trailing white spaces. More...

void	G_str_to_upper (char *str)
	Convert string to upper case. More...

void	G_str_to_lower (char *str)
	Convert string to lower case. More...

int	G_str_to_sql (char *str)
	Make string SQL compliant. More...

void	G_squeeze (char *line)
	Remove superfluous white space. More...

char *	G_strcasestr (const char str, const char substr)
	Finds the first occurrence of the sub-string in the null-terminated string ignoring case (upper or lower) More...

Detailed Description

GIS Library - Find raster map.

GIS Library - string/chring movement functions.

This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.

Author: Original author CERL

Todo:: merge interesting functions from ../datetime/scan.c here

This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.

Author: Dave Gerdes (USACERL); Michael Shapiro (USACERL); Amit Parghi (USACERL); Bernhard Reiter (Intevation GmbH, Germany) and many others

Definition in file strings.c.

Macro Definition Documentation

◆ NULL

#define NULL 0

Definition at line 26 of file strings.c.

Function Documentation

◆ G_chop()

char* G_chop ( char * line )

Chop leading and trailing white spaces.

space, \f, \n, \r, \t, \v

Modified copy of G_squeeze() by RB in March 2000.

Parameters

line	buffer to be worked on

Returns: pointer to string

Definition at line 286 of file strings.c.

Referenced by check_create_export_opts(), check_create_import_opts(), check_mapset_in_layer_name(), G_str_to_color(), and read_coor().

◆ G_squeeze()

void G_squeeze ( char * line )

Remove superfluous white space.

Leading and trailing white space is removed from the string line and internal white space which is more than one character is reduced to a single space character. White space here means spaces, tabs, linefeeds, newlines, and formfeeds.

Parameters

[in,out] line

Returns: Pointer to line

Definition at line 399 of file strings.c.

◆ G_store()

char* G_store ( const char * s )

Copy string to allocated memory.

This routine allocates enough memory to hold the string s, copies s to the allocated memory, and returns a pointer to the allocated memory.

If s is NULL then empty string is returned.

Parameters

s string

Returns: pointer to newly allocated string

Definition at line 86 of file strings.c.

Referenced by cairo_read_ppm(), cairo_write_ppm(), G__read_Cell_head(), G_add_keyword(), G_config_path(), G_fully_qualified_name(), G_get_available_mapsets(), G_ls2(), G_myname(), G_option_to_separator(), G_parser(), G_putenv(), G_str_replace(), GPJ__get_datum_params(), GPJ_get_datum_by_name(), GPJ_get_default_datum_params_by_name(), GPJ_get_ellipsoid_by_name(), GPJ_get_equivalent_latlong(), GPJ_init_transform(), GPJ_osr_to_grass(), M__add_element(), read_pgm(), and write_pgm().

◆ G_store_lower()

char* G_store_lower ( const char * s )

Copy string to allocated memory and convert copied string to lower case.

This routine allocates enough memory to hold the string s, copies s to the allocated memory, and returns a pointer to the allocated memory.

If s is NULL then empty string is returned.

Parameters

s string

Returns: pointer to newly allocated lower case string

Definition at line 140 of file strings.c.

◆ G_store_upper()

char* G_store_upper ( const char * s )

Copy string to allocated memory and convert copied string to upper case.

This routine allocates enough memory to hold the string s, copies s to the allocated memory, and returns a pointer to the allocated memory.

If s is NULL then empty string is returned.

Parameters

s string

Returns: pointer to newly allocated upper case string

Definition at line 116 of file strings.c.

Referenced by GPJ_init_transform().

◆ G_str_replace()

char* G_str_replace	(	const char *	buffer,
		const char *	old_str,
		const char *	new_str
	)

Replace all occurrences of old_str in buffer with new_str.

Code example:

char *name;
name = G_str_replace ( inbuf, ".exe", "" );
... 
G_free (name);

Parameters

buffer	input string buffer
old_str	string to be replaced
new_str	new string

Returns: the newly allocated string, input buffer is unchanged

Definition at line 188 of file strings.c.

References count, G_store(), and NULL.

◆ G_str_to_lower()

void G_str_to_lower ( char * str )

Convert string to lower case.

Parameters

[in,out] str pointer to string

Definition at line 336 of file strings.c.

◆ G_str_to_sql()

int G_str_to_sql ( char * str )

Make string SQL compliant.

Parameters

[in,out] str pointer to string

Returns: number of changed characters

Definition at line 356 of file strings.c.

References count.

◆ G_str_to_upper()

void G_str_to_upper ( char * str )

Convert string to upper case.

Parameters

[in,out] str pointer to string

Definition at line 318 of file strings.c.

◆ G_strcasecmp()

int G_strcasecmp	(	const char *	x,
		const char *	y
	)

String compare ignoring case (upper or lower)

Returning a value that has the same sign as the difference between the first differing pair of characters.

Note: strcasecmp() is affected by the locale (LC_CTYPE), while G_strcasecmp() isn't.

Parameters

x	first string to compare
y	second string to compare

Returns: 0 the two strings are equal; -1, 1

Definition at line 46 of file strings.c.

Referenced by AS_option_to_algorithm(), Cairo_Graph_set(), check_mapset_in_layer_name(), clean_dir(), G_compressor_number(), G_str_to_color(), GPJ_get_datum_by_name(), GPJ_get_ellipsoid_by_name(), GPJ_osr_to_grass(), M_do_copy(), M_do_remove(), M_do_rename(), M_get_element(), PNG_Graph_set(), read_image(), and write_image().

◆ G_strcasestr()

char* G_strcasestr	(	const char *	str,
		const char *	substr
	)

Finds the first occurrence of the sub-string in the null-terminated string ignoring case (upper or lower)

Parameters

str	string where to find sub-string
substr	sub-string

Returns: a pointer to the first occurrence of sub-string; NULL if no occurrences are found

Definition at line 430 of file strings.c.

References G_strncasecmp(), and NULL.

◆ G_strchg()

char* G_strchg	(	char *	bug,
		char	character,
		char	new
	)

Replace all occurrences of character in string bug with new.

Parameters

[in,out]	bug	base string
	character	character to replace
	new	new character

Returns: bug string

Definition at line 159 of file strings.c.

◆ G_strip()

void G_strip ( char * buf )

Removes all leading and trailing white space from string.

Parameters

[in,out] buf buffer to be worked on

Definition at line 258 of file strings.c.

◆ G_strncasecmp()

int G_strncasecmp	(	const char *	x,
		const char *	y,
		int	n
	)

String compare ignoring case (upper or lower) - limited number of characters.

Returning a value that has the same sign as the difference between the first differing pair of characters.

Note: strcasecmp() is affected by the locale (LC_CTYPE), while G_strcasecmp() isn't.

Parameters

x	first string to compare
y	second string to compare
n	number or characters to compare

Returns: 0 the two strings are equal; -1, 1

Definition at line 68 of file strings.c.

Referenced by check_create_export_opts(), check_create_import_opts(), and G_strcasestr().

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ NULL

Function Documentation

◆ G_chop()

◆ G_squeeze()

◆ G_store()

◆ G_store_lower()

◆ G_store_upper()

◆ G_str_replace()

◆ G_str_to_lower()

◆ G_str_to_sql()

◆ G_str_to_upper()

◆ G_strcasecmp()

◆ G_strcasestr()

◆ G_strchg()

◆ G_strip()

◆ G_strncasecmp()