12.3. Funciones para cadenas de caracetres

MySQL 5.0

12.3. Funciones para cadenas de caracetres

Las funciones de cadenas de carácteres retornan si la longitud del resultado es mayor que el valor de la variable de sistema . Consulte Sección 7.5.2, “Afinar parámetros del servidor”.

Para funciones que operan en posiciones de cadenas de carácteres, la primera posición es la 1.

  • )

    Retorna el valor numérico del carácter más a la izquierda de la cadena de carácteres . Retorna 0 si es la cadena vacía. Retorna si es . funciona para carácteres con valores numéricos de 0 a 255.

    mysql> SELECT ASCII('2');
            -> 50
    mysql> SELECT ASCII(2);
            -> 50
    mysql> SELECT ASCII('dx');
            -> 100
    

    Consulte la función .

  • )

    Retorna una representación de cadena de carácteres del valor binario de , donde es un número muy largo () . Esto es equivalente a ,10,2). Retorna si es .

    mysql> SELECT BIN(12);
            -> '1100'
    

  • )

    Retorna la longitud de la cadena de carácteres en bits.

    mysql> SELECT BIT_LENGTH('text');
            -> 32
    

  • ,...)

    interpreta los argumentos como enteros y retorna la cadena de carácteres que consiste en los carácteres dados por los códigos de tales enteros. Los valores no se tienen en cuenta.

    mysql> SELECT CHAR(77,121,83,81,'76');
            -> 'MySQL'
    mysql> SELECT CHAR(77,77.3,'77.3');
            -> 'MMM'
    

  • )

    Retorna la longitud de la cadena de carácteres , medida en carácteres. Un carácter de múltiples bytes cuenta como un sólo carácter. Esto significa que para una cadena de carácteres que contiene cinco carácteres de dos bytes, retorna , mientras returna .

  • )

    es sinónimo de .

  • )

    Comprime una cadena de carácteres. Esta función necesita que MySQL se compile con una biblioteca de compresión como . De otro modo, el valor retornado siempre es . La cadena comprimida puede descomprimirse con .

    mysql> SELECT LENGTH(COMPRESS(REPEAT('a',1000)));
            -> 21
    mysql> SELECT LENGTH(COMPRESS(''));
            -> 0
    mysql> SELECT LENGTH(COMPRESS('a'));
            -> 13
    mysql> SELECT LENGTH(COMPRESS(REPEAT('a',16)));
            -> 15
    

    Los contenidos comprimidos se almacenan de la siguiente forma:

    • Cadenas vacías se almacenan como cadenas vacías.

    • Cadenas no vacías se almacenan como longitud de cuatros bytes de la cadena descomprimida (los bytes más bajos primero), seguido de la cadena comprimida. Si la cadena acaba con un espacio, se añade un carácter '' para evitar problemas con eliminación de espacios finales al almacenar en una columna o . (El uso de o para almacenar cadenas comprimidas no se recomienda. Es mejor usar una columna .)

  • ,,...)

    Retorna la cadena resultado de concatenar los argumentos. Retorna si algúna argumento es . Puede tener uno o más argumentos. Si todos los argumentos son cadenas no binarias, el resultado es una cadena no binaria. Si los argumentos incluyen cualquier cadena binaria, el resultado es una cadena binaria. Un argumento numérico se convierte a su forma de cadena binaria equivalente; si quiere evitarlo puede usar conversión de tipos explícita, como en este ejemplo:

    mysql> SELECT CONCAT('My', 'S', 'QL');
            -> 'MySQL'
    mysql> SELECT CONCAT('My', NULL, 'QL');
            -> NULL
    mysql> SELECT CONCAT(14.3);
            -> '14.3'
    

  • ,,,...)

    significa CONCAT With Separator (CONCAT con separador) y es una forma especial de . El primer argumento es el separador para el resto de argumentos. El separador se añade entre las cadenas a concatenar. El separador puede ser una cadena como el resto de argumentos. Si el separador es , el resultado es . La función evita valores tras el argumento separador.

    mysql> SELECT CONCAT_WS(',','First name','Second name','Last Name');
            -> 'First name,Second name,Last Name'
    mysql> SELECT CONCAT_WS(',','First name',NULL,'Last Name');
            -> 'First name,Last Name'
    

    En MySQL 5.0, no evita cadenas vacías. (Sin embargo, evita s.)

  • ,,)

    Convierte números entre diferentes bases numéricas. Retorna una representación de cadena de carácters para el número , convertido de base a base . Retorna si algún argumento es . El argumento se interpreta como entero, pero puede especificarse como un entero o cadena. La base mínima es y la máxima es . Su es un número negativo, se trata como un número con signo. De otro modo, se trata como sin signo. funciona con precisión de 64-bit.

    mysql> SELECT CONV('a',16,2);
            -> '1010'
    mysql> SELECT CONV('6E',18,8);
            -> '172'
    mysql> SELECT CONV(-17,10,-18);
            -> '-H'
    mysql> SELECT CONV(10+'10'+'10'+0xa,10,10);
            -> '40'
    

  • ,,,,...)

    Retorna si = , if = , y así. Retorna si es menor que o mayor que el número de argumentos. es el complemento de .

    mysql> SELECT ELT(1, 'ej', 'Heja', 'hej', 'foo');
            -> 'ej'
    mysql> SELECT ELT(4, 'ej', 'Heja', 'hej', 'foo');
            -> 'foo'
    

  • ,,[,[,]])

    Retorna una cadena en que para cada bit del valor , puede obtener una cadena y para cada bit reasignado obtiene una cadena . Los bits en se examinan de derecha a izquierda (de bits menores a mayores). Las cadenas se añaden al resultado de izquierda a derecha, separados por la cadena (siendo el carácter por defecto la coma ''). El número de bits examinados se obtiene por (por defecto 64).

    mysql> SELECT EXPORT_SET(5,'Y','N',',',4);
            -> 'Y,N,Y,N'
    mysql> SELECT EXPORT_SET(6,'1','0',',',10);
            -> '0,1,1,0,0,0,0,0,0,0'
    

  • ,,,,...)

    Retorna el índice de en la lista , , , . Retorna si no se encuentra .

    Si todos los argumentos de son cadenas, todos los argumentos se comparan como cadenas. Si todos los argumentos son números, se comparan como números. De otro modo, los argumentos se comparan como números con doble precisión.

    Si es , el valor retornado es porque falla en comparaciones de comparación con cualquier valor. es el complemento de .

    mysql> SELECT FIELD('ej', 'Hej', 'ej', 'Heja', 'hej', 'foo');
            -> 2
    mysql> SELECT FIELD('fo', 'Hej', 'ej', 'Heja', 'hej', 'foo');
            -> 0
    

  • ,)

    Retorna un valor en el rango de 1 a si la cadena está en la lista de cadenas consistente de subcadenas. Una lista de cadenas es una cadena compuesta de subcadenas separadas por carácteres '' . Si el primer argumento es una cadena constante y el segundo es una columna de tipo , la función está optimizada para usar aritmética de bit. Retorna 0 si no está en o si es la cadena vacía. Retorna si algún argumento es . Esta función no funciona apropiadamente si el primer argumento contiene un carácter de coma ('') .

    mysql> SELECT FIND_IN_SET('b','a,b,c,d');
            -> 2
    

  • )

    Si es un número, retorna una cadena representación del valor hexadecimal de , donde es un número muy grande () . Esto es equivalente a .

    Si es una cadena, esta función retorna una cadena hexadecimal de carácteres, donde cada carácter en se convierte a dos dígitos hexadecimales.

    mysql> SELECT HEX(255);
            -> 'FF'
    mysql> SELECT 0x616263;
            -> 'abc'
    mysql> SELECT HEX('abc');
            -> 616263
    

  • ,,,)

    Retorna la cadena , con la subcadena comenzando en la posición y carácteres reemplazados por la cadena . Retorna la cadena original si no está entre la longitud de la cadena. Replaza el resto de la cadena a partir de la posición si no está dentro de la longitud del resto de la cadena. Retorna si cualquier argumento es nulo.

    mysql> SELECT INSERT('Quadratic', 3, 4, 'What');
            -> 'QuWhattic'
    mysql> SELECT INSERT('Quadratic', -1, 4, 'What');
            -> 'Quadratic'
    mysql> SELECT INSERT('Quadratic', 3, 100, 'What');
            -> 'QuWhat'
    

    Esta función está preparada para funcionar con múltiples bytes.

  • ,)

    Retorna la posición de la primera ocurrencia de la subcadena en la cadena . Es lo mismo que la forma de dos argumentos de , excepto que el orden de los argumentos es inverso.

    mysql> SELECT INSTR('foobarbar', 'bar');
            -> 4
    mysql> SELECT INSTR('xbar', 'foobar');
            -> 0
    

    Esta función puede trabajar con múltiples bytes. En MySQL 5.0, sólo es sensible a mayúsculas si uno de los argumentos es una cadena binaria.

  • )

    es sinónimo de .

  • ,)

    Retorna los carácteres empezando por la izquierda de la cadena .

    mysql> SELECT LEFT('foobarbar', 5);
            -> 'fooba'
    

  • )

    Retorna la longitud de la cadena , medida en bytes.Un carácter multi-byte cuenta como múltiples bytes. Esto significa que para cadenas que contengan cinco carácteres de dos bytes, retorna 10, mientras que retorna 5.

    mysql> SELECT LENGTH('text');
            -> 4
    

  • )

    Lee el fichero y retorna el contenido como cadena de carácteres. El fichero debe estar localizado en el servidor, debe especificar la ruta completa al fichero, y debe tener el privilegio . El fichero debe ser legible por todo el mundo y su tamaño menor a bytes.

    Si el fichero no existe o no puede ser leído debido a que una de las anteriores condiciones no se cumple, la función retorna .

    mysql> UPDATE 
               SET =LOAD_FILE('/tmp/picture')
               WHERE id=1;
    

  • ,) , ,,)

    La primera sintaxis retorna la posición de la primera ocurrencia de la subcadena en la cadena . La segunda sintaxis retorna la posición de la primera ocurrencia de la subcadena en la cadena , comanzando en la posición . Retorna 0 si no está en .

    mysql> SELECT LOCATE('bar', 'foobarbar');
            -> 4
    mysql> SELECT LOCATE('xbar', 'foobar');
            -> 0
    mysql> SELECT LOCATE('bar', 'foobarbar',5);
            -> 7
    

    Esta función trabaja con múltiples bytes. En MySQL 5.0, es sensible a mayúsculas sólo si algún argumento es una cadena binaria.

  • )

    Retorna la cadena con todos los carácteres cambiados a minúsculas según el mapeo del conjunto de carácteres actual (por defecto es ISO-8859-1 Latin1).

    mysql> SELECT LOWER('QUADRATICALLY');
            -> 'quadratically'
    

    Esta función funciona con múltiples bytes.

  • ,,)

    Retorna la cadena , alineado a la izquierda con la cadena a una longitud de carácteres. Si es mayor que , el valor retornado se acorta a carácteres.

    mysql> SELECT LPAD('hi',4,'??');
            -> '??hi'
    mysql> SELECT LPAD('hi',1,'??');
            -> 'h'
    

  • )

    Retorna la cadena con los carácteres en blanco iniciales eliminados.

    mysql> SELECT LTRIM('  barbar');
            -> 'barbar'
    

    Esta función trabaja con múltiples bytes.

  • ,,,...)

    Retorna un conjunto de valores (una cadena conteniendo subcadenas separadas por carácteres '' ) consistiendo en cadenas que tienen el bit correspondiente en asignado. se corresponde al bit 0, al bit 1, y así. Los valores en , , no se añaden al resultado.

    mysql> SELECT MAKE_SET(1,'a','b','c');
            -> 'a'
    mysql> SELECT MAKE_SET(1 | 4,'hello','nice','world');
            -> 'hello,world'
    mysql> SELECT MAKE_SET(1 | 4,'hello','nice',NULL,'world');
            -> 'hello'
    mysql> SELECT MAKE_SET(0,'a','b','c');
            -> ''
    

  • ,,)

    ,,) es sinónimo de ,,).

  • )

    Retorna una representación en cadena del valor octal de , donde es un número largo (). Es equivalente a . Retorna si es .

    mysql> SELECT OCT(12);
            -> '14'
    

  • )

    es sinónimo de .

  • )

    Si el carácter más a la izquierda de la cadena es un carácter multi-byte , retorna el código de ese carácter, calculado a partir del valor numérico de sus bytes usando esta fórmula:

      (1st byte code)
    + (2nd byte code * 256)
    + (3rd byte code * 256^2) ...
    

    Si el caráctar más a la izquierda no es multi-byte , retorna el mismo valor que la función .

    mysql> SELECT ORD('2');
            -> 50
    

  • IN )

    IN ) es sinónimo de ,).

  • )

    Acota una cadena para producir un resultado que puede usarse como un valor con carácteres de escape en un comando SQL. La cadena se retorna rodeado por comillas sencillas y con cada instancia de comilla sencilla (''), antibarra (''), ASCII NUL, y Control-Z predecidos por una antibarra. Si el argumento es , el valor de retorno es la palabra “NULL” sin comillas alrededor.

    mysql> SELECT QUOTE('Don\'t!');
            -> 'Don\'t!'
    mysql> SELECT QUOTE(NULL);
            -> NULL
    

  • ,)

    Retorna una cadena consistente de la cadena repetida veces. Si <= 0, retorna una cadena vacía. Retorna si o son .

    mysql> SELECT REPEAT('MySQL', 3);
            -> 'MySQLMySQLMySQL'
    

  • ,,)

    Retorna la cadena con todas las ocurrencias de la cadena reemplazadas con la cadena .

    mysql> SELECT REPLACE('www.mysql.com', 'w', 'Ww');
            -> 'WwWwWw.mysql.com'
    

    Esta función trabaja con múltiples bytes.

  • )

    Retorna la cadena con el orden de los carácteres invertido.

    mysql> SELECT REVERSE('abc');
            -> 'cba'
    

    Esta función trabaja con múltiples bytes.

  • ,)

    Retorna los carácteres de la derecha de la cadena .

    mysql> SELECT RIGHT('foobarbar', 4);
            -> 'rbar'
    

    Esta función trabaja con múltiples bytes.

  • ,,)

    Retorna la cadena , alineada a la derecha con la cadena con una longitud de carácteres. Si es mayor que , el valor de retorno se corta a carácteres.

    mysql> SELECT RPAD('hi',5,'?');
            -> 'hi???'
    mysql> SELECT RPAD('hi',1,'?');
            -> 'h'
    

    Esta función trabaja con múltiples bytes.

  • )

    Retorna la cadena con los espacios precedentes eliminados.

    mysql> SELECT RTRIM('barbar   ');
            -> 'barbar'
    

    Esta función trabaja con múltiples bytes.

  • )

    Retorna una cadena soudex de . Dos cadenas que suenen igual deben tener cadenas soundex idénticas. Una cadena soundex estándar tiene cuatro carácteres de longitud, pero la función retorna una cadena arbitráriamente larga. Puede usar en el resultado para obtener una cadena soundex estándar. Todos los carácteres no alfabéticos en se ignoran. Todos los carácteres alfabéticos internacionales fuera del rango A-Z se tratan como vocales.

    mysql> SELECT SOUNDEX('Hello');
            -> 'H400'
    mysql> SELECT SOUNDEX('Quadratically');
            -> 'Q36324'
    

    Nota: Esta función implementa el algoritmo Soundex original, no la versión más popular (descrita por D. Hnuth). La diferencia es que la versión original descarta vocales primero y luego duplicados, mientras que la versión mejorada descarta primero los duplicados y luego las vocales.

  • SOUNDS LIKE

    Es lo mismo que ) = SOUNDEX().

  • )

    Retorna la cadena consistente en carácteres blancos.

    mysql> SELECT SPACE(6);
            -> '      '
    

  • ,) , FROM ), ,,) , FROM FOR )

    Las formas sin el arguemnto retornan una subcadena de la cadena comenzando en la posición . Las formas con el argumento retornan una subcadena de longitud a partir de la cadena , comenzando en la posición .Las formas que usan son sintaxis SQL estándard. En MySQL 5.0, es posible usar valores negativos para . En este caso, el inicio de la subcadena son carácteres a partir del final de la cadena, en lugar del principio. Un valor negativo puede usarse para en cualquier de las formas de esta función.

    mysql> SELECT SUBSTRING('Quadratically',5);
            -> 'ratically'
    mysql> SELECT SUBSTRING('foobarbar' FROM 4);
            -> 'barbar'
    mysql> SELECT SUBSTRING('Quadratically',5,6);
            -> 'ratica'        
    mysql> SELECT SUBSTRING('Sakila', -3);
            -> 'ila'        
    mysql> SELECT SUBSTRING('Sakila', -5, 3);
            -> 'aki'
    mysql> SELECT SUBSTRING('Sakila' FROM -4 FOR 2);
            -> 'ki'
    

    Esta función trabaja con múltiples bytes.

    Tenga en cuenta que si usa un valor menor a 1 para , el resultado siempre es una cadena vacía.

    es sinónimo de .

  • ,,)

    Retorna la subcadena de la cadena antes de ocurrencias del delimitador . Si es positivo, todo a la izquierda del delimitador final (contando desde la izquierda) se retorna. Si es negativo, todo a la derecha del delimitador final (contando desde la derecha) se retorna.

    mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', 2);
            -> 'www.mysql'
    mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', -2);
            -> 'mysql.com'
    

    Esta función trabaja con múltiples bytes.

  • ] FROM] ), FROM] )

    Retorna la cadena con todos los prefijos y/o sufijos eliminados. Si ninguno de los especificadores , , o se da, se asumen. Si es opcional y no se especifica, los espacios se eliminan.

    mysql> SELECT TRIM('  bar   ');
            -> 'bar'
    mysql> SELECT TRIM(LEADING 'x' FROM 'xxxbarxxx');
            -> 'barxxx'
    mysql> SELECT TRIM(BOTH 'x' FROM 'xxxbarxxx');
            -> 'bar'
    mysql> SELECT TRIM(TRAILING 'xyz' FROM 'barxxyz');
            -> 'barx'
    

    Esta función trabaja con múltiples bytes.

  • )

    es sinónimo de .

  • )

    Descomprime una cadena comprimida con la función . Si el argumento no es un valor comprimido, el resultado es . Esta función necesita que MySQL se compile con una biblioteca de compresión tal como . De otro modo, el valor de retorno siempre es .

    mysql> SELECT UNCOMPRESS(COMPRESS('any string'));
            -> 'any string'
    mysql> SELECT UNCOMPRESS('any string');
            -> NULL
    

  • )

    Retorna la longitud de una cadena comprimida antes de la compresión.

    mysql> SELECT UNCOMPRESSED_LENGTH(COMPRESS(REPEAT('a',30)));
            -> 30
    

  • )

    Realiza la operación opuesta a ). Esto es, interpreta cada par de dígitos hexadecimales en el argumento como números y los convierte al carácter representado por el número. El carácteres resultantes se retornan como cadena binaria.

    mysql> SELECT UNHEX('4D7953514C');
            -> 'MySQL'
    mysql> SELECT 0x4D7953514C;
            -> 'MySQL'
    mysql> SELECT UNHEX(HEX('string'));
            -> 'string'
    mysql> SELECT HEX(UNHEX('1267'));
            -> '1267'
    

  • )

    Retorna la cadena con todos los carácteres cambiados a mayúsculas según el mapeo del conjunto de carácteres actual (por defecto es ISO-8859-1 Latin1).

    mysql> SELECT UPPER('Hej');
            -> 'HEJ'
    

    Esta función trabaja con múltiples bytes.

12.3.1. Funciones de comparación de cadenas de caracteres

MySQL convierte automáticamente números a cadenas según es necesario y viceversa.

mysql> SELECT 1+'1';
        -> 2
mysql> SELECT CONCAT(2,' test');
        -> '2 test'

Si quiere convertir un número a cadena explícitamente, use la función :

mysql> SELECT 38.8, CAST(38.8 AS CHAR);
        -> 38.8, '38.8'

Si una función de cadenas da una cadena binaria como argumento, la cadena resultante también es binaria. Un número convertido a cadena se trata como cadena binaria (esto es, es sensible a mayúsculas en comparaciones). Esto afecta sólo a comparaciones.

Normalmente, si una expresión en una comparación de cadenas es sensible a mayúsculas, la comparación se realiza con sensibilidad a mayúsculas.

  • LIKE [ESCAPE '']

    Coincidencia de patrones usando comparación mediante expresiones regulares SQL. Retorna 1 () o 0 (). Si o es , el resultado es .

    El patrón no puede ser una cadena literal. Por ejemplo, puede especificarse como expresión de cadena o columna.

    Con puede usar los siguientes dos carácteres comodín en el patrón:

    Carácter Descrición
    Coincidencia de cualquier número de carácteres, incluso cero carácteres
    Coincide exactemente un carácter
    mysql> SELECT 'David!' LIKE 'David_';
            -> 1
    mysql> SELECT 'David!' LIKE '%D%v%';
            -> 1
    

    Para testear instancias literales de un carácter comodín, preceda el carácter con el carácter de escape. Si no especifica el carácter , se asume '' .

    Cadena Descrición
    Coincide un carácter ''
    Coincide un carácter ''
    mysql> SELECT 'David!' LIKE 'David\_';
            -> 0
    mysql> SELECT 'David_' LIKE 'David\_';
            -> 1
    

    Para especificar un carácter de escape distinto, use la cláusula :

    mysql> SELECT 'David_' LIKE 'David|_' ESCAPE '|';
            -> 1
    

    Los siguientes dos comandos ilustran que la comparación de cadenas no son sensibles a mayúsculas a no ser que uno de los operandos sea una cadena binaria:

    mysql> SELECT 'abc' LIKE 'ABC';
            -> 1
    mysql> SELECT 'abc' LIKE BINARY 'ABC';
            -> 0
    

    En MySQL, se permite en expresiones numéricas. (Esta es una extensión del SQL estándar .)

    mysql> SELECT 10 LIKE '1%';
            -> 1
    

    Nota: Debido a que MySQL usa sintaxis de escape C en cadenas (por ejemplo, '' para representar carácter de nueva línea), debe doblar cualquier '' que use en cadenas . Por ejemplo, para buscar '', especifíquelo como ''. Para buscar '', especifíquelo como ''; esto es debido a que las antibarras se eliminan una vez por el parser y otra vez cuando la coincidencia con el patrón se realiza, dejando una única antibarra para comparar.

  • NOT LIKE [ESCAPE '']

    Es lo mismo que LIKE [ESCAPE '']).

  • NOT REGEXP , NOT RLIKE

    Es lo mismo que REGEXP ).

  • REGEXP , RLIKE

    Realiza una comparación de patrones de una expresión de cadena de carácteres contra un patrón . El patrón puede ser una expresión regular extendida. La sintaxis para expresiones regulares se discute en Apéndice F, Expresiones regulares en MySQL. Retorna 1 si coincide con , de otro modo retorna 0. Si o es , el resultado es . es un sinónimo de , debido a compatibilidad con .

    El patrón no necesita ser una cadena literal. Por ejemplo, puede especificarse como una expresión de cadena o columna.

    Nota: Debido a que MySQL usa la sintaxis de escape de C en cadenas (por ejemplo, '' para representar una nueva línea), de doblar cualquier '' que use en sus cadenas .

    no es sensible a mayúsculas, excepto cuando se usa con cadenas binarias.

    mysql> SELECT 'Monty!' REGEXP 'm%y%%';
            -> 0
    mysql> SELECT 'Monty!' REGEXP '.*';
            -> 1
    mysql> SELECT 'new*\n*line' REGEXP 'new\\*.\\*line';
            -> 1
    mysql> SELECT 'a' REGEXP 'A', 'a' REGEXP BINARY 'A';
            -> 1  0
    mysql> SELECT 'a' REGEXP '^[a-d]';
            -> 1
    

    y usan el conjunto de carácteres actual (ISO-8859-1 Latin1 por defecto) al decidir el tipo de un carácter. Atención: Estos operadores no pueden trabajar con múltiples bytes.

  • ,)

    retorna 0 si las cadenas son idénticas, -1 si el primer argumento es menor que el segundo según el orden actual, y 1 en cualquier otro caso.

    mysql> SELECT STRCMP('text', 'text2');
            -> -1
    mysql> SELECT STRCMP('text2', 'text');
            -> 1
    mysql> SELECT STRCMP('text', 'text');
            -> 0
    

    En MySQL 5.0, usa el conjunto de carácteres actual cuando realizac comparaciones. Esto hace el comportamiento de comparaciones por defecto insensible a mayúsculas a no ser que alguno de los operandos sea una cadena binaria.