SUBSTRING_INDEX()

Description

This function SUBSTRING_INDEX() returns the substring from string str before count occurrences of the delimiter delim.

If count is positive, everything to the left of the final delimiter (counting from the left) is returned.

If count is negative, everything to the right of the final delimiter (counting from the right) is returned. SUBSTRING_INDEX() performs a case-sensitive match when searching for delim.

SUBSTRING_INDEX() returns NULL if any of its arguments are NULL.

Syntax

  1. > SUBSTRING_INDEX(str,delim,count)

Arguments

ArgumentsDescription
strA string.
delimA delimiter.
countAn integer indicating the number of occurrences of delim.

Examples

  1. mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', 2);
  2. +--------------------------------------+
  3. | substring_index(www.mysql.com, ., 2) |
  4. +--------------------------------------+
  5. | www.mysql                            |
  6. +--------------------------------------+
  7. 1 row in set (0.03 sec)
  9. mysql> select substring_index('xyz', 'abc', 9223372036854775808);
  10. +------------------------------------------------+
  11. | substring_index(xyz, abc, 9223372036854775808) |
  12. +------------------------------------------------+
  13. | xyz                                            |
  14. +------------------------------------------------+
  15. 1 row in set (0.02 sec)
  17. mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', -2);
  18. +---------------------------------------+
  19. | substring_index(www.mysql.com, ., -2) |
  20. +---------------------------------------+
  21. | mysql.com                             |
  22. +---------------------------------------+
  23. 1 row in set (0.02 sec)
  25. mysql> SELECT SUBSTRING_INDEX(SUBSTRING_INDEX('192,168,8,203', ',', 2), ',',-1);
  26. +--------------------------------------------------------------+
  27. | substring_index(substring_index(192,168,8,203, ,, 2), ,, -1) |
  28. +--------------------------------------------------------------+
  29. | 168                                                          |
  30. +--------------------------------------------------------------+
  31. 1 row in set (0.02 sec)
  33. create table test(a varchar(100), b varchar(20), c int);
  34. insert into test values('www.mysql.com', '.', 0);
  35. insert into test values('www.mysql.com', '.', 1);
  36. insert into test values('www.mysql.com', '.', 2);
  37. insert into test values('www.mysql.com', '.', 3);
  38. insert into test values('www.mysql.com', '.', 9223372036854775808);
  39. insert into test values('www.mysql.com', '.', -1);
  40. insert into test values('www.mysql.com', '.', -2);
  41. insert into test values('www.mysql.com', '.', -3);
  42. mysql> select SUBSTRING_INDEX(a, b, c) from test;
  43. +--------------------------+
  44. | substring_index(a, b, c) |
  45. +--------------------------+
  46. |                          |
  47. | www                      |
  48. | www.mysql                |
  49. | www.mysql.com            |
  50. | com                      |
  51. | mysql.com                |
  52. | www.mysql.com            |
  53. +--------------------------+
  54. 7 rows in set (0.02 sec)