| 773 /** @name String Functions */ |
773 /** @name String Functions */ |
| 774 /**************************************************************************/ |
774 /**************************************************************************/ |
| 775 /*@{*/ |
775 /*@{*/ |
| 776 |
776 |
| 777 /** |
777 /** |
| |
778 * Tests two strings for equality. |
| |
779 * |
| |
780 * Unlike strcmp(), this function will not crash if one or both of the |
| |
781 * strings are @c NULL. |
| |
782 * |
| |
783 * @param left A string |
| |
784 * @param right A string to compare with left |
| |
785 * |
| |
786 * @return @c TRUE if the strings are the same, else @c FALSE. |
| |
787 * @since 2.6.0 |
| |
788 */ |
| |
789 gboolean purple_strequal(const gchar *left, const gchar *right); |
| |
790 |
| |
791 /** |
| 778 * Normalizes a string, so that it is suitable for comparison. |
792 * Normalizes a string, so that it is suitable for comparison. |
| 779 * |
793 * |
| 780 * The returned string will point to a static buffer, so if the |
794 * The returned string will point to a static buffer, so if the |
| 781 * string is intended to be kept long-term, you <i>must</i> |
795 * string is intended to be kept long-term, you <i>must</i> |
| 782 * g_strdup() it. Also, calling normalize() twice in the same line |
796 * g_strdup() it. Also, calling normalize() twice in the same line |