Funciones de Cadena en GML

En algn punto del desarrollo de tu juego, ser necesario usar texto. El texto se maneja mediante las funciones de cadena (una cadena es otra manerade referirse a una lnea de texto). A continuacin se presentan las funciones para trabajar con cadenas.

1. chr2. ord3. real4. string5. ansi_char6. string_byte_at7. string_byte_length8. string_set_byte_at9. string_char_at

10. string_copy11. string_count12. string_delete13. string_digits14. string_format15. string_insert16. string_letters17. string_lettersdigits18. string_lower19. string_pos20. string_repeat21. string_replace22. string_replace_all23. string_upper24. string_height25. string_height_ext26. string_width27. string_width_ext

Adems de las funciones anteriores, que especficamente trabajan con cadenas, GM:S permite acceder al portapapeles de la plataforma Windows paraobtener y ajustar texto:

1. clipboard_get_text2. clipboard_has_text3. clipboard_set_text

chr

Devuelve una cadena conteniendo el caracter con el cdigo Unicode especificado.

Sintaxis:

chr(val);

Argumento Descripcinval El cdigo unicode del caracter.

Devuelve: String

Descripcin

Esta funcin devuelve una cadena conteniendo el caracter que corresponde al cdigo Unicode introducido. Este caracter depende de la pgina decdigos del juego de caracteres de la fuente que se emplea para dibujar, pero si no se ha fijado ninguna fuente, se usar la pgina de cdigos pordefecto.

Ejemplo:

mystring = chr(53) + chr(48);

Esto ajustar mystring a "50" (como cadena, no como entero) ya que chr(53) es "5" y chr(48) es "0".

ord

Devuelve el valor del cdigo Unicode del primer caracter en la cadena dada.

Sintaxis:

ord(str);

Argumento Descripcinstr El caracter del cul obtener el cdigo Unicode.

devuelve: Real

Descripcin

Esta funcin toma una cadena (de un nico caracter) y devuelve el valor Unicode de ese caracter. De esta forma es posible almacenar pulsaciones deteclas individuales como enteros, y es comnnmente usada por las funciones keyboard_check()

Ejemplo:

if keyboard_check(ord("W")) { y -= 4;

}

Esto mover la instancia que ejecuta el cdigo cuatro pixeles hacia arriba si se presiona la tecla W.

real

Toma una cadena y la convierte en un nmero de tipo real.

Sintaxis:

real( str );

Argumento Descripcinstr La cadena a convertir en un valor real.

Devuelve: Real

Descripcin

Esta funcin se usa para convertir una cadena en un nmero real. Cuando se usa esta funcin, los nmeros, el signo menos, puntos decimales y partesexponenciales en la cadena son tomados en cuenta, mientras que otros caracteres (como las letras) producirn un error. Si se sabe o se sospecha que lacadena pudiera contener otros caracteres, antes de usar sta funcin se puede usar la funcin string_digits() para remover todos los caracteres nonumricos.

Ejemplo:

var t_str;t_str = cadena_digits(input_str);age = real(t_str);

El cdigo anterior tomara la cadena t_str, remover todos los caracteres que no sean nmeros, y la transformar en un nmero real que se almacena enla variable "age".

string

Transforma un numero real en una cadena.

Sintaxis:

string(val);

Argumento Descripcinstr El numero real a convertir en cadena.

Devuelve: Cadena

Descripcin

Esta funcin permite convertir cualquier nmero real en cadena. Si el nmero real es un entero, ser guardado sin decimales, de lo contrario, serguardado con dos cifras decimales.

Ejemplo:

draw_text(100, 100, "Score: " + string(score) + " / Health: " + string(health));

El cdigo anterior utiliza la funcin string para dibujar tanto nmeros reales como cadenas juntos (draw acepta o una cadena o un real, pero noambos).

ansi_char

Devuelve una cadena contieniendo el caracter con el valor del BYTE especificado.

Sintaxis

ansi_char(val);

Argumentoo Descripcinval El valor del byte.

Devuelve: Cadena (caracter sencillo)

Descripcin

Esta funcin devuelve una cadena consistente en el caracter equivalente al valor de byte especificado. El caracter devuelto no puede, ni debera, serdesplegado, pero s se guardar de manera correcta en disco para su uso en codificacin.

string_byte_at

Devuelve el valor (como tipo real) del byte en la posicin dada para la cadena especificada.

Sintaxis:

string_byte_at(str, index);

Argumento Descripcinstr La cadena a revisar.index La posicin de la cual obtener el byte.

Devuelve: Real

Ejemplo:

newbyte = string_byte_at("Hello World", 6);

Este cdigo ajusta la variable newbyte al valor del sexto byte de la cadena "Hello World".

string_byte_length

Devuelve el nmero de bytes en la cadena.

Sintaxis:

string_byte_length( str );

Argumentoo Descripcinstr La cadena de la cual contabilizar el nmero de bytes.

devuelve: Real

Descripcin

Esta funcin devuelve el nmero de bytes en la cadena, pero es preciso notar que debido a que se maneja codificacin UTF8, este nmero no serigual a la longitud de la cadena.

Ejemplo:

bytesize = string_byte_length("Hello World");

Esto ajusta "bytesize" al nmero de bytes en la cadena "Hello World".

string_set_byte_at

Ajusta el byte indicado en una cadena.

Sintaxis:

string_set_byte_at(str, pos, byte);

Argumento Descripcinstr La cadena en la cual cambiar el byte.pos La posicin (comenzando en 1) donde cambiar el byte.byte El nuevo valor del byte.

Devuelve:Cadena

Descripcin

Esta funcin ajusta sirectamente un byte en la cadena (basado en el formato UTF8) y devuelve una copia de la cadena con los cambios.

NOTA: Esta funcin resulta increblemente lenta, lo que exige considerar si es realmente necesaria y dnde usarla.

Ejemplo:

str = string_set_byte_at("hello", 2, 97);

El cdigo anterior cambia el valor del byte de la segunda letra en la cadena, por lo que la variable "str" se reajusta para almacenar la cadena "hallo".

string_char_at

Revisa una cadena y devuelve el caracter en la posicin indicada.

Sintaxis:

string_char_at(str, index);

Argumento Descripcinstr La cadena a revisar.index La posicin de la cual obtener el caracter.

Devuelve: Cadena

Descripcin

Esta funcin se usa para devolver un caracter en una posicin especfica dentro de una cadena, con el el ndice comenzando en 1 para el primercaracter. Si no se encuentra un caracter o la cadena es ms corta que el valor de ndice especificado, la funcin devuelve una cadena vaca "" .

Ejemplo:

str1 = "Hello World";str2 = string_char_at(str1, 7);

Esto ajusta str2 al sptimo caracter ("H" cuenta como el primero) en la cadena, en este caso, la letra "W".

string_copy

devuelve una copia total o parcial de una cadena.

Sintaxis:

string_copy(str, index, count);

Argumento Descripcinstr La cadena de la cual hacer la copia.index La posicin del primer caracter en la cadena original (numerados a partir de 1)count El nmero de caracteres a copiar, comenzando por la posicin especificada por el argumento anterior

Devuelve: cadena

Descripcin

Mediante esta funcin es posible seleccionar determinado nmero de caracteres dentro de una cadena para copiarse en otra. El primer caracter de unacadena siepre est numerado como "1", as que por ejemplo, para copiar los cinco primeros caracteres de una cadena, se usara string_copy(str, 1,5). En seguida se incluye un ejemplo adicional.

Ejemplo:

name = keyboard_string;if string_length(name) > 15 ) { keyboard_string = string_copy(name, 1, 15 ); }

El cdigo anterior le permite al usuario introducir una cadena mediante el teclado, la cual se almacena en la variable "name". Esta cadena se revisapara determinar si excede la longitud mxima de 15 caracteres, y si esto ocurre, la variable keyboard_string se reemplaza por una copia de losprimeros 15 caracteres de la variable "name". Esto limita la entrada del usuario a 15 caracteres.

string_count

Devuelve el nmero de ocurrencias de una subcadena dentro de una cadena dada.

Sintaxis:

string_count(substr, str);

Argumento Descripcinsubstr La subcadena a buscar.str La cadena en dnde buscar.

Devuelve: Real

Descripcin

Esta funcin devuelve el nmero de veces que la subcadena especificada aparece dentro de una cadena especfica. De esta manera se puede sabercuntas veces se repite una letra o una frase en una seccin de texto.

Ejemplo:

str1 = "Hello World";ocount = string_count( "o", str1 );

El nmero de o's en str1 se guarda en la variable "count", en este caso 2.

string_delete

devuelve una copia de la cadena dada, pero con una seccin borrada.

Sintaxis:

string_delete(str, index, count);

Argumento Descripcinstr La cadena a copiar y de la cual borrar.index La posicin del primer caracter a borrar.count El nmero de caracteres a borrar.

Devuelve: String

Descripcin

Esta funcin se usa para eliminar una seccin especfica de una cadena. Esto se hace especificando la cadena de entrada, y las posiciones inicial yfinal dentro de esa cadena para remover caracteres (el ndice comienza en 1). La funcin devolver una cadena nueva sin la seccin.

Ejemplo:

str1 = "Helloo World";str2 = string_delete(str1, 5, 1);

El cdigo anterior ajusta str2 a "Hello World", al eliminar la "o" de ms en la palabra "Helloo": La funcin cuenta 5 lugares desde la primer letra, yluego borra 1 caracter.

string_digits

devuelve una copia de la cadena especificada, pero descartando todos los caracteres que no sean dgitos.

Sintaxis:

string_digits( str );

Argumento Descripcinstr la cadena de la cual extraer los dgitos.

Devuelve: Cadena

Descripcin

Esta funcin se usa para analizar una cadena y obtener cualquier nmero dentro de ella. Por ejemplo, si se teiene el texto "Tengo 18 aos", medianteesta funcin se obtendra la cadena "18".

Ejemplo:

var t_str;t_str = string_digits(input_str);age = real(t_str);

Este cdigo toma la cadena de ntrada, desecha todos los caracteres no numricos, transforma la cadena devuelta en un nmero real y guarda ese valoren la variable "age".

string_format

Transforma un nmero en una cadena usando un formato personalizado.

Sintaxis:

string_format(val, tot, dec);

Argumento Descripcinval El nmero (tipo real) a convertir en cadena.tot Cantidad total de lugares a desplegar para el nmero principal. Se agregarn ceros o espacios para igualar esta cantidad.dec Cantidad de posiciones decimales a inclur.

Devuelve: Cadena

Descripcin

Transforma un nmero real en una cadena usando un formato personalizado, en donde se puede escoger cuntas cifras se guardan en la cadena ycuntos lugares decimales se usan. Esto resulta til en ciertos juegos donde se requiere desplegar un score con determinado nmero de dgitos o msexactitud en los decimales de la que ofrece la funcin string(), la cual slo tiene dos lugares para decimales. Si el nmero de lugares indicados esmayor que el valor mostrado, y/o el nmero (contando los decimales especificados) es menor que el total de lugares especificado, se agregarnespacios en blanco antes del valor para compensar la diferencia (ver el siguiente ejemplo).

Ejemplo:

str1 = string_format(1234, 8, 0);str2 = string_format(pi, 1, 10);str3 = string_format(pi, 5, 5);

Esto ajusta str1 a " 1234", str2 a "3.1415926535" y str3 a " 3.14159".

string_insert

Devuelve unac copia de la cadena dada, pero con una subcadena insertada en una posicin especfica.

Sintaxis:

string_insert(substr, str, index);

Argumento Descripcinsubstr la sub-cadena a insertar.str La cadena a copiar (en donde se insertar la subcadena).index La posicin (en caracteres) en la cual insertar la sub-cadena.

Devuelve: Cadena

Descripcin

Esta funcin sirve para crear una nueva cadena a partir de dos cadenas, en la cual una se inserta en la otra en una determinada posicin. Por ejemplo,

puede darse el caso de (como en muchos RPG's) tener que agregar un nombre de usuario en un texto predefinido para personalizar la experiencia dejuego.

Ejemplo:

str2 = string_insert(username, "Hola, , cmo ests", 6);

Este cdigo toma la cadena en la variable "username" y la inserta en la frase predefinida, logrando que en la cadena resultante se tenga: "Hola,NOMBRE, cmo ests".

string_letters

Devuelve una copia de la cadena dada, pero con todos los caracteres no alfabticos eliminados.

Sintaxis:

string_letters(str);

Argumento Descripcinstr La cadena a convertir en slo letras.

Devuelve: Cadena

Descripcin

Mediante esta funcin es posible remover todos los caracteres que no califican como letras del alfabeto. Esto es til cuando se desea prevenir que elusuario introduzca caracteres no deseados, por ejemplo introducir "#" para forzar un salto de lnea en GML.

Nota: Esta funcin solo detecta los 26 caracteres del alfabeto ingls de A-Z.

Ejemplo:

username = string_letters(username);

El cdigo anterior ajustar la variable "username" para que slo contenga las letras de la cadena original.

string_lettersdigits

Devuelve la copia de una cadena dada, eliminando los smbolos y dejando nicamente nmeros y letras.

Sintaxis:

string_lettersdigits(str);

Argumento Descripcinstr The string to convert to letters and digits.

Devuelve: Cadena

Descripcin

Esta funcin devuelve la copia de una cadena dada con todos sus smbolos eliminados excepto nmeros y letras, lo que significa que puede ser usadapara remover cualquier carcter indeseado, por ejemplo "#" o "?" en un nombre de usuario o una contrasea/clave.

Nota: Esta funcin solo detecta los 26 caracteres del alfabeto ingls de A-Z.

Ejemplo:

if string_length(password) > string_length(string_lettersdigits(password)) { draw_text(32,32,"Clave Invalida! Solo nmeros y letras por favor!"); }

El cdigo de anterior verifica el tamao de la cadena respecto al tamao de la misma cadena, pero con todos los smbolos removidos. Si no son delmismo tamao un mensaje se desplegara en pantalla.

string_lower

devuelve una copia de la cadena indicada con todas sus letras en minscula.

Sintaxis:

string_lower( str );

Argumento Descripcinstr The string to convert to lowercase.

Devuelve: String

Descripcin

Con esta funcin puedes forzar una cadena a que contenga unicamente caracteres en minscula.

Nota: Esta Funcin solo detecta los 26 caracteres del alfabeto ingls de A-Z.

Ejemplo:

str1 = "Hola, Mundo";str2 = string_lower(str1);

Esto establecer el valor de str2 como "hola, mundo".

string_replace

Devuelve una copia de una cadena, con la primer sub-cadena reemplazada por una segunda (nueva) sub-cadena.

Sintaxis:

string_replace(str, substr, newstr);

Argumento Descripcinstr La cadena acopiar.substr La sub-cadena a reemplazar.newstr La nueva subcadena que reemplazar a la anterior en la cadena str.

Devuelve: Cadena

Descripcin

Esta funcin se usa para verificar una cadena, en busca de una parte en especfico, la cual puede ser reemplazada por una nueva cadena.

Ejemplo:

str1 = 'Hola Tierra';str2 = string_replace(str1, 'Tierra', 'Mundo');

Este cdigo ajustar str2 a str1, pero con la diferencia de que 'Tierra' es substituda por 'Mundo', resultando entonces que en str2 se tiene 'HolaMundo'.

string_height

devuelve la altura en pixeles de una cadena.

Sintaxis:

string_height(string);

Argumento Descripcinstring La cadena de la cual medir la altura.

Devuelve: Real

Descripcin

Esta funcin devuelve la altura (en pixeles) de la cadena de entrada. Es muy til para calcular distancias entre elementos de texto basndose en la letrams alta dentro de la cadena, como si fuera dibujada mediante la funcin draw_text usando la fuente actualmente definida.

Ejemplo:

var hh;hh = string_height("ABCDEFGHIJKLMNOPQRSTUVWXYZ");draw_text(32, 32, string(score));draw_text(32, 32 + hh, string(lives);

El cdigo anterior obtiene la altura de la cadena especificada y dibuja dos lneas de texto, usando la altura devuelta como separador.

string_height_ext

Devuelve la altura (en pixels) de una cadena, con base en la separacin especificada y el ancho del fin de lnea.

Sintaxis:

string_height_ext(string, sep, w);

Argumento Descripcin

string la cadena de la cual medir la altura.sep La distancia en pixels entre lneas, tal como si la cadena estuviera dibujada en pantalla.w El mximo ancho de la cadena antes de saltar a una nueva lnea, como si la cadena estuviera dibujada en pantalla.

Devuelve: Real

Descripcin

Esta funcin devuelve la altura (en pixels) de la cadena de entrada, considerando la separacin entre lneas y el ancho del fin de lnea. Es til cuandose desea calcular distancias entre elementos de texto basndose en la letra ms alta as como la longitud real de la cadena cuando el texto se divide enmltiples lneas, como debera aparecer desplegado al usar la funcin draw_text_ext usando la fuente actualmente definida. la separacin y el anchopueden ajustarse a -1 para obtener el espacio por defecto.

Ejemplo:

var hh;hh = string_height_ext(str_Story_Text[1], -1, 100);draw_text_ext(32, 32, str_Story_Text[1], -1, 100);draw_text_ext(32, 32 + hh, str_Story_Text[2], -1, 100);

ste cdigo obtiene la altura de la cadena dada, tomando adems en cuenta la separacin interlineal y el ancho del fin de lnea. A continuacin dibujados lneas de texto usando la altura total devuelta como separador.

string_lower

devuelve una copia de la cadena indicada con todas sus letras en minscula.

Sintaxis:

string_lower( str );

Argumento Descripcinstr La cadena a convertir en minsculas.

Devuelve: String

Descripcin

Con esta funcin puedes forzar una cadena a que contenga unicamente caracteres en minscula.

Nota: Esta Funcin solo detecta los 26 caracteres del alfabeto ingles de A-Z.

Ejemplo:

str1 = "Hola, Mundo";str2 = string_lower(str1);

Esto establecer el valor de str2 como "hola, mundo".

string_pos

Devuelve la posicin de una sub-cadena dada dentro de una cadena.

Sintaxis:

string_pos(substr, str);

Argumento Descripcinsubstr La sub-cadena a buscar en la cadenastr La cadena.

Devuelve: Cadena

Descripcin

Esta funcin devuelve la posicin de caracter para una instancia de la subcadena dentro de otra cadena, o 0 si no se encuentra ninguna. Un uso paraesta funcin es el de filtrar palabras que se podran considerar ofensivas, o para encontrar el lugar correcto para insertar algn texto en otra cadena.

Ejemplo:

if string_pos(",", text) != 0 { string_insert(name, text, string_pos(",", text)); }

El cdigo anterior busca una coma en la cadena almacenada en text, y si la encuentra entonces inserta la sub-cadena "name" en esa posicin.

string_replace

Devuelve una copia de una cadena, con la primer sub-cadena reemplazada por una segunda (nueva) sub-cadena.

Sintaxis:

string_replace(str, substr, newstr);

Argumento Descripcinstr La cadena acopiar.substr La sub-cadena a reemplazar.newstr La nueva subcadena que reemplazar a la anterior en la cadena str.

Devuelve: Cadena

Descripcin

Esta funcin se usa para verificar una cadena, en busca de una parte en especfico, la cual puede ser reemplazada por una nueva cadena.

Ejemplo:

str1 = 'Hola Tierra';str2 = string_replace(str1, 'Tierra', 'Mundo');

Este cdigo ajustar str2 a str1, pero con la diferencia de que 'Tierra' es substituda por 'Mundo', resultando entonces que en str2 se tiene 'HolaMundo'.

string_replace_all

Devuelve una copia de un cadena con todas las instancias de un determinada subcadena reemplazadas por una nueva subcadena.

Sintaxis:

string_replace_all(str, substr, newstr);

Argumento Descripcinstr La cadena a copiar.substr La sub-cadena dentro de str, la cual ser reemplazada en todas sus instancias.newstr La nueva sub-cadena que reemplazar al substring anterior.

Devuelve: Cadena

Descripcin

Esta funcin se usa para analizar una cadena en busca de partes especficas, las cuales pueden ser reemplazadas por la nueva cadena que se elija entodos los lugares en donde ocurra la coincidencia.

Ejemplo:

str1 = 'Hexxo Worxd';str2 = string_replace_all(str1, 'x', 'l');

A str2 se le asigna str1, pero con todas las instancias de 'x' reemplazadas por 'l'. El resultado es str2 como 'Hello World'.

string_repeat

Devuelve la copia de una cadena dada repetida un numero dado de veces.

Sintaxis:

string_repeat(str, count);

Argumento Descripcinstr La cadena a Repetir.count El numero de veces a repetir la cadena.

Devuelve: Cadena

Descripcin

Esta funcin simplemente devuelve la misma cadena repetida el numero de veces indicado.

Ejemplo:

str1 = 'Hola Mundo';

str2 = string_repeat(str1, 3);

Esto establecer el valor de str2 a 'Hola MundoHola MundoHola Mundo'.

string_upper

Devuelve una copia en maysculas de la cadena indicada.

Sintaxis:

string_upper( str );

Argumento Descripcinstr La cadena a convertir en maysculas.

Devuelve: String

Descripcin

Esta funcin sirve para forzar a que una cadena contenga slo caracteres en maysculas.Nota: Esta funcin solo funciona con las 26 letras del alfabeto ingls de A - Z.

Ejemplo:

str1 = 'Hello World';str2 = string_upper( str1 );

Esto ajusta str2 a 'HELLO WORLD'.

string_width

devuelve el ancho en pixeles de una cadena dada.

Sintaxis:

string_width(string);

Argumento Descripcinstring La cadena a medir.

devuelve: Real

Descripcin

Esta funcin devuelve el ancho (en pixeles) de la cadena indicada. Resulta muy til para calcular distancias entre elementos de texto basados en elancho total de las letras que componen la cadena como si se dibujara con draw_text usando la tipografa actual.

Ejemplo:

var ww;ww = string_width(str_Name + " ");draw_text(32, 32, str_Name));draw_text(32 + ww, 32, "has won the game!");

El cdigo anterior obtendr el ancho de el string dado y entonces dibujar dos lneas de texto, usando el ancho total devuelto por la funcin comoseparador.

string_width_ext

Devuelve el mximo ancho en pixeles de una cadena basado en la separacin dada y el ancho del salto de linea.

Sintaxis:

string_width_ext(string, sep, w);

Argumento Descripcinstring La cadena de la cual medir su ancho.sep La distancia en pixeles entre las lineas del texto, como si la cadena se estuviera dibujando.w El ancho mximo de la cadena antes de un salto de linea, como si la cadena se estuviera dibujando.

devuelve: Real

Descripcin

Esta funcin devolver el ancho mximo (en pixeles) de la cadena de entrada, tomando en cuenta la separacin entre linea y el ancho del salto delinea. Es muy til para calcular distancias entre elementos de texto basndose en el ancho mximo de una cadena que se divide en varias lineas, comosi fuera a ser dibujada con draw_text_ext utilizando la fuente de texto definida actualmente. La separacin y el ancho pueden especificarse como -1para obtener el espaciado por defecto.

Ejemplo:

var ww;ww = string_width_ext(str_Story_Text[1], -1, 100);draw_text_ext(32, 32, str_Story_Text[1], -1, 100);draw_text_ext(32 + ww, 32, str_Story_Text[2], -1, 100);

El cdigo anterior obtendr el ancho de la cadena dada, tomando en cuenta la separacin entre lineas y el ancho del salto de linea, y luego dibujar doslineas del texto, usando el ancho total de la cadena devuelto como un separador.

clipboard_get_text

Devuelve el texto almacenado actualmente en el portapapeles.

Sintaxis:

clipboard_get_text();

Devuelve: Cadena

Descripcin

Esta funcin devuelve una cadena de texto con el contenido del portapapeles, si no hay texto en l, se devuelve una cadena vaca"".

NOTA: Esta funcin slo es vlida para la plataforma Windows.

Ejemplo:

if clipboard_has_text() { str = clipboard_get_text(); clipboard_set_text(""); }

El cdigo anterior revisa si hay texto en el portapapeles, y de haberlo, se guarda como cadena en la variable "str". Por ltimo, se limpia el portapapelesdndole un valor de cadena vaca.

clipboard_has_text

Devuelve si el portapapeles contiene texto.

Sintaxis:

clipboard_has_text();

Devuelve: Boleano

Descripcin

Esta funcin devuelve true si el portapapeles contiene texto o false si no.

NOTA: Esta funcin es slo vlida para la plataforma Windows.

Ejemplo:

if clipboard_has_text() { str = clipboard_get_text(); clipboard_set_text(""); }

El cdigo anterior revisar el portapapeles en busca de texto y si contiene, lo asignara como una cadena a la variable "str". Finalmente el contenido delportapapeles es borrado asignndole una cadena vaca.

clipboard_set_text

Ajusta el texto del portapapeles para que contenga la cadena indicada.

Sintaxis:

clipboard_set_text(str);

Argumento Descripcin

str The text (as a cadena) to set the clipboard to hold.

devuelve: N/A

Descripcin

Esta funcin colocar un texto definido en el portapapeles. Es posible asignarle una cadena vaca "" para efectivamente borrar el texto delportapapeles.

NOTA: Esta funcin es slo vlida para la plataforma Windows.

Ejemplo:

if clipboard_has_text() { str = clipboard_get_text(); clipboard_set_text(""); }

El cdigo anterior revisa el portapapeles en busca de texto y de haberlo, lo asignara como una cadena a la variable "str". Finalmente el portapapeles esborrado al asignarle una cadena vaca.