# Glom::Utils Namespace Reference

## Typedefs

typedef std::vector< sharedptr < LayoutItem_Field > > | type_vecLayoutFields
typedef std::vector< sharedptr < const LayoutItem_Field > > | type_vecConstLayoutFields
typedef std::list< std::pair < Gnome::Gda::Value, Gnome::Gda::Value > > | type_list_values_with_second
typedef std::vector < Glib::ustring > | type_vec_strings

## Functions

Glib::ustring | trim_whitespace (const Glib::ustring& text)
Glib::ustring | string_replace (const Glib::ustring& src, const Glib::ustring search_for, const Glib::ustring& replace_with)
Glib::ustring | build_sql_select_fields_to_get (const Glib::ustring& table_name, const type_vecConstLayoutFields& fieldsToGet, const type_sort_clause& sort_clause, Glib::ustring& sql_part_from, Glib::ustring& sql_part_leftouterjoin)
| Generate a SQL statement to SELECT field values, even if the fields are in related (or doubly related) records.
Glib::ustring | build_sql_select_with_where_clause (const Glib::ustring& table_name, const type_vecLayoutFields& fieldsToGet, const Glib::ustring& where_clause=Glib::ustring(), const Glib::ustring& extra_join=Glib::ustring(), const type_sort_clause& sort_clause=type_sort_clause(), const Glib::ustring& extra_group_by=Glib::ustring())
| Generate a SQL statement to SELECT field values, even if the fields are in related (or doubly related) records, narrowing the records down with a WHERE clause.
Glib::ustring | build_sql_select_with_where_clause (const Glib::ustring& table_name, const type_vecConstLayoutFields& fieldsToGet, const Glib::ustring& where_clause=Glib::ustring(), const Glib::ustring& extra_join=Glib::ustring(), const type_sort_clause& sort_clause=type_sort_clause(), const Glib::ustring& extra_group_by=Glib::ustring())
| Just a version of build_sql_select_with_where_clause() that takes a list of const fields.
Glib::ustring | build_sql_select_with_key (const Glib::ustring& table_name, const type_vecLayoutFields& fieldsToGet, const sharedptr< const Field >& key_field, const Gnome::Gda::Value& key_value)
Glib::ustring | build_sql_select_with_key (const Glib::ustring& table_name, const type_vecConstLayoutFields& fieldsToGet, const sharedptr< const Field >& key_field, const Gnome::Gda::Value& key_value)
| Just a version of build_sql_select_with_key() that takes a list of const fields.
type_list_values_with_second | get_choice_values (const sharedptr< const LayoutItem_Field >& field)
Glib::ustring | create_name_from_title (const Glib::ustring& title)
| Guess an appropriate identifier name based on a human-readable title.
Glib::ustring | string_escape_underscores (const Glib::ustring& text)
Glib::ustring | locale_simplify (const Glib::ustring& locale_id)
| Get just the first part of a locale, such as de_DE, ignoring, for instance, .UTF-8 or @euro at the end.
Glib::ustring | locale_language_id (const Glib::ustring& locale_id)
| Get just the language ID part of a locale, such as de from "de_DE",.
Glib::ustring | create_local_image_uri (const Gnome::Gda::Value& value)
Glib::ustring | string_from_decimal (guint decimal)
| Get a decimal text representation of the number, in the current locale.
Glib::ustring | title_from_string (const Glib::ustring& text)
| Create an appropriate title for an ID string.
type_vec_strings | string_separate (const Glib::ustring& str, const Glib::ustring& separator, bool ignore_quoted_separator=false)
Glib::ustring | string_trim (const Glib::ustring& str, const Glib::ustring& to_remove)
Glib::ustring | string_remove_suffix (const Glib::ustring& str, const Glib::ustring& suffix, bool case_sensitive=true)
bool | file_exists (const Glib::ustring& uri)

## Typedef Documentation

typedef std::list< std::pair<Gnome::Gda::Value, Gnome::Gda::Value> > Glom::Utils::type_list_values_with_second

typedef std::vector<Glib::ustring> Glom::Utils::type_vec_strings

typedef std::vector< sharedptr<const LayoutItem_Field> > Glom::Utils::type_vecConstLayoutFields

typedef std::vector< sharedptr<LayoutItem_Field> > Glom::Utils::type_vecLayoutFields

## Function Documentation

Glib::ustring Glom::Utils::build_sql_select_fields_to_get | ( | const Glib::ustring & | table_name,
|  | const type_vecConstLayoutFields & | fieldsToGet,
|  | const type_sort_clause & | sort_clause,
|  | Glib::ustring & | sql_part_from,
|  | Glib::ustring & | sql_part_leftouterjoin |
| ) |  |  |

Generate a SQL statement to SELECT field values, even if the fields are in related (or doubly related) records.

Glib::ustring Glom::Utils::build_sql_select_with_key | ( | const Glib::ustring & | table_name,
|  | const type_vecConstLayoutFields & | fieldsToGet,
|  | const sharedptr< const Field > & | key_field,
|  | const Gnome::Gda::Value & | key_value |
| ) |  |  |

Just a version of build_sql_select_with_key() that takes a list of const fields.

Glib::ustring Glom::Utils::build_sql_select_with_key | ( | const Glib::ustring & | table_name,
|  | const type_vecLayoutFields & | fieldsToGet,
|  | const sharedptr< const Field > & | key_field,
|  | const Gnome::Gda::Value & | key_value |
| ) |  |  |

Glib::ustring Glom::Utils::build_sql_select_with_where_clause | ( | const Glib::ustring & | table_name,
|  | const type_vecConstLayoutFields & | fieldsToGet,
|  | const Glib::ustring & | where_clause = `Glib::ustring()`,
|  | const Glib::ustring & | extra_join = `Glib::ustring()`,
|  | const type_sort_clause & | sort_clause = `type_sort_clause()`,
|  | const Glib::ustring & | extra_group_by = `Glib::ustring()` |
| ) |  |  |

Just a version of build_sql_select_with_where_clause() that takes a list of const fields.

Glib::ustring Glom::Utils::build_sql_select_with_where_clause | ( | const Glib::ustring & | table_name,
|  | const type_vecLayoutFields & | fieldsToGet,
|  | const Glib::ustring & | where_clause = `Glib::ustring()`,
|  | const Glib::ustring & | extra_join = `Glib::ustring()`,
|  | const type_sort_clause & | sort_clause = `type_sort_clause()`,
|  | const Glib::ustring & | extra_group_by = `Glib::ustring()` |
| ) |  |  |

Generate a SQL statement to SELECT field values, even if the fields are in related (or doubly related) records, narrowing the records down with a WHERE clause.

Glib::ustring Glom::Utils::create_local_image_uri | ( | const Gnome::Gda::Value & | value | ) |

Glib::ustring Glom::Utils::create_name_from_title | ( | const Glib::ustring & | title | ) |

Guess an appropriate identifier name based on a human-readable title.

bool Glom::Utils::file_exists | ( | const Glib::ustring & | uri | ) |

Utils::type_list_values_with_second Glom::Utils::get_choice_values | ( | const sharedptr< const LayoutItem_Field > & | field | ) |

Glib::ustring Glom::Utils::locale_language_id | ( | const Glib::ustring & | locale_id | ) |

Get just the language ID part of a locale, such as de from "de_DE",.

Glib::ustring Glom::Utils::locale_simplify | ( | const Glib::ustring & | locale_id | ) |

Get just the first part of a locale, such as de_DE, ignoring, for instance, .UTF-8 or @euro at the end.

Get just the first part of a locale, such as de_DE, ignoring, for instance, .UTF-8 or at the end.

Glib::ustring Glom::Utils::string_escape_underscores | ( | const Glib::ustring & | text | ) |

Glib::ustring Glom::Utils::string_from_decimal | ( | guint | decimal | ) |

Get a decimal text representation of the number, in the current locale.

Glib::ustring Glom::Utils::string_remove_suffix | ( | const Glib::ustring & | str,
|  | const Glib::ustring & | suffix,
|  | bool | case_sensitive = `true` |
| ) |  |  |

Glib::ustring Glom::Utils::string_replace | ( | const Glib::ustring & | src,
|  | const Glib::ustring | search_for,
|  | const Glib::ustring & | replace_with |
| ) |  |  |

Utils::type_vec_strings Glom::Utils::string_separate | ( | const Glib::ustring & | str,
|  | const Glib::ustring & | separator,
|  | bool | ignore_quoted_separator = `false` |
| ) |  |  |

Glib::ustring Glom::Utils::string_trim | ( | const Glib::ustring & | str,
|  | const Glib::ustring & | to_remove |
| ) |  |  |

Glib::ustring Glom::Utils::title_from_string | ( | const Glib::ustring & | text | ) |

Create an appropriate title for an ID string.

For instance, date_of_birth would become Date Of Birth.

Glib::ustring Glom::Utils::trim_whitespace | ( | const Glib::ustring & | text | ) |