a

ASCII (uguale a nessuno). Questa è l'impostazione predefinita.

e

EUC.

n

Nessuno (come ASCII).

u

UTF-8.

str % arg

Formatta una stringa utilizzando una specifica di formato. arg deve essere un array se contiene più di una sostituzione. Per informazioni sulla specifica del formato, vedere sprintf in "Modulo kernel".

str * integer

Restituisce una nuova stringa contenente un numero intero moltiplicato per str. In altre parole, str è un numero intero ripetuto.

str + other_str

Concatena other_str a str.

str << obj

Concatena un oggetto a str. Se l'oggetto è un numero fisso nell'intervallo 0,255, viene convertito in un carattere. Confrontalo con concat.

str <=> other_str

Confronta str con other_str, restituendo -1 (minore di), 0 (uguale) o 1 (maggiore di). Il confronto fa distinzione tra maiuscole e minuscole.

str == obj

Verifica l'uguaglianza di str e obj. Se obj non è una stringa, restituisce false; restituisce true se str <=> obj restituisce 0.

str =~ obj

Confronta str con un modello di espressione regolare obj. Restituisce la posizione in cui inizia la partita; in caso contrario, false.

str.capitalize

Capitalizza una stringa.

str.capitalize!

Uguale a capitalize, ma le modifiche vengono apportate sul posto.

str.casecmp

Effettua un confronto tra le stringhe senza distinzione tra maiuscole e minuscole.

str.center

Centra una stringa.

str.chomp

Rimuove il separatore di record ($ /), solitamente \ n, dalla fine di una stringa. Se non esiste alcun separatore di record, non fa nulla.

str.chomp!

Uguale a chomp, ma le modifiche vengono apportate sul posto.

str.chop

Rimuove l'ultimo carattere in str.

str.chop!

Uguale a chop, ma le modifiche vengono apportate sul posto.

str.concat(other_str)

Concatena other_str a str.

str.count(str, ...)

Conta uno o più set di caratteri. Se è presente più di un set di caratteri, conta l'intersezione di tali set

str.crypt(other_str)

Applica un hash crittografico unidirezionale a str. L'argomento è la stringa salt, che dovrebbe essere lunga due caratteri, ogni carattere nell'intervallo az, AZ, 0.9,. o /.

str.delete(other_str, ...)

Restituisce una copia di str con tutti i caratteri nell'intersezione dei suoi argomenti eliminati.

str.delete!(other_str, ...)

Uguale a Elimina, ma le modifiche vengono apportate sul posto.

str.downcase

Restituisce una copia di str con tutte le lettere maiuscole sostituite da minuscole.

str.downcase!

Uguale al downcase, ma le modifiche vengono apportate.

str.dump

Restituisce una versione di str con tutti i caratteri non stampabili sostituiti dalla notazione \ nnn e tutti i caratteri speciali con escape.

str.each(separator = $/) { |substr| block }

Divide str utilizzando l'argomento come separatore di record ($ / per impostazione predefinita), passando ogni sottostringa al blocco fornito.

str.each_byte { |fixnum| block }

Passa ogni byte da str al blocco, restituendo ogni byte come rappresentazione decimale del byte.

str.each_line(separator=$/) { |substr| block }

Divide str utilizzando l'argomento come separatore di record ($ / per impostazione predefinita), passando ogni sottostringa al blocco fornito.

str.empty?

Restituisce vero se str è vuoto (ha lunghezza zero).

str.eql?(other)

Due stringhe sono uguali se hanno la stessa lunghezza e contenuto.

str.gsub(pattern, replacement) [or]

str.gsub(pattern) { |match| block }

Restituisce una copia di str con tutte le occorrenze di pattern sostituite con la sostituzione o il valore del blocco. Il pattern sarà tipicamente un Regexp; se è una stringa, non verranno interpretati i metacaratteri delle espressioni regolari (ovvero / \ d / corrisponderà a una cifra, ma "\ d" corrisponderà a una barra rovesciata seguita da una "d")

str[fixnum] [or] str[fixnum,fixnum] [or] str[range] [or] str[regexp] [or] str[regexp, fixnum] [or] str[other_str]

Fa riferimento a str, utilizzando i seguenti argomenti: one Fixnum, restituisce un codice carattere in fixnum; due Fixnum, restituisce una sottostringa a partire da un offset (primo fixnum) fino a length (secondo fixnum); intervallo, restituisce una sottostringa nell'intervallo; regexp restituisce una parte della stringa corrispondente; regexp con fixnum, restituisce i dati corrispondenti a fixnum; other_str restituisce la sottostringa che corrisponde a other_str. Un Fixnum negativo inizia alla fine della stringa con -1.

str[fixnum] = fixnum [or] str[fixnum] = new_str [or] str[fixnum, fixnum] = new_str [or] str[range] = aString [or] str[regexp] = new_str [or] str[regexp, fixnum] = new_str [or] str[other_str] = new_str ]

Sostituisci (assegna) tutto o parte di una stringa. Sinonimo di slice !.

str.gsub!(pattern, replacement) [or] str.gsub!(pattern) { |match|block }

Esegue le sostituzioni di String # gsub in posizione, restituendo str o nil se non sono state eseguite sostituzioni.

str.hash

Restituisce un hash in base alla lunghezza e al contenuto della stringa.

str.hex

Tratta i caratteri iniziali di str come una stringa di cifre esadecimali (con un segno facoltativo e uno 0x facoltativo) e restituisce il numero corrispondente. Zero viene restituito in caso di errore.

str.include? other_str [or] str.include? fixnum

Restituisce vero se str contiene la stringa o il carattere specificato.

str.index(substring [, offset]) [or]

str.index(fixnum [, offset]) [or]

str.index(regexp [, offset])

Restituisce l'indice della prima occorrenza della sottostringa, del carattere (fixnum) o del pattern (regexp) in str. Restituisce zero se non trovato. Se è presente il secondo parametro, specifica la posizione nella stringa per iniziare la ricerca.

str.insert(index, other_str)

Inserisce altro_str prima del carattere all'indice dato, modificando str. Gli indici negativi contano dalla fine della stringa e vengono inseriti dopo il carattere specificato. L'intento è inserire una stringa in modo che inizi dall'indice specificato.

str.inspect

Restituisce una versione stampabile di str, con caratteri speciali di escape.

str.intern [or] str.to_sym

Restituisce il Simbolo corrispondente a str, creando il simbolo se non esisteva in precedenza.

str.length

Restituisce la lunghezza di str. Confronta le dimensioni.

str.ljust(integer, padstr = ' ')

Se intero è maggiore della lunghezza di str, restituisce una nuova stringa di lunghezza intero con str allineato a sinistra e riempito con padstr; in caso contrario, restituisce str.

str.lstrip

Restituisce una copia di str con gli spazi iniziali rimossi.

str.lstrip!

Rimuove gli spazi bianchi iniziali da str, restituendo nil se non è stata apportata alcuna modifica.

str.match(pattern)

Converte pattern in un Regexp (se non lo è già), quindi invoca il suo metodo match su str.

str.oct

Tratta i caratteri iniziali di str come una stringa di cifre ottali (con un segno opzionale) e restituisce il numero corrispondente. Restituisce 0 se la conversione non riesce.

str.replace(other_str)

Sostituisce il contenuto e la contaminazione di str con i valori corrispondenti in other_str.

str.reverse

Restituisce una nuova stringa con i caratteri di str in ordine inverso.

str.reverse!

Inverte str in posizione.

str.rindex(substring [, fixnum]) [or]

str.rindex(fixnum [, fixnum]) [or]

str.rindex(regexp [, fixnum])

Restituisce l'indice dell'ultima occorrenza della sottostringa, del carattere (fixnum) o del pattern (regexp) in str. Restituisce zero se non trovato. Se il secondo parametro è presente, specifica la posizione nella stringa per terminare la ricerca. I caratteri oltre questo punto non verranno considerati.

str.rjust(integer, padstr = ' ')

Se intero è maggiore della lunghezza di str, restituisce una nuova stringa di lunghezza intero con str giustificato a destra e riempito con padstr; in caso contrario, restituisce str.

str.rstrip

Restituisce una copia di str con gli spazi vuoti finali rimossi.

str.rstrip!

Rimuove gli spazi vuoti finali da str, restituendo zero se non è stata apportata alcuna modifica.

str.scan(pattern) [or]

str.scan(pattern) { |match, ...| block }

Entrambe le forme eseguono l'iterazione attraverso str, corrispondenti al modello (che può essere un Regexp o una String). Per ogni corrispondenza, viene generato un risultato e aggiunto all'array dei risultati o passato al blocco. Se il pattern non contiene gruppi, ogni singolo risultato è costituito dalla stringa corrispondente, $ &. Se il pattern contiene gruppi, ogni singolo risultato è esso stesso un array contenente una voce per gruppo.

str.slice(fixnum) [or] str.slice(fixnum, fixnum) [or]

str.slice(range) [or] str.slice(regexp) [or]

str.slice(regexp, fixnum) [or] str.slice(other_str)

See str[fixnum], etc.

str.slice!(fixnum) [or] str.slice!(fixnum, fixnum) [or]

str.slice!(range) [or] str.slice!(regexp) [or]

str.slice!(other_str)

Elimina la parte specificata da str e restituisce la parte eliminata. I form che accettano un Fixnum solleveranno un IndexError se il valore è fuori intervallo; il modulo Range solleverà un RangeError e i form Regexp e String ignoreranno silenziosamente l'assegnazione.

str.split(pattern = $, [limit])

Divide str in sottostringhe in base a un delimitatore, restituendo un array di queste sottostringhe.

Se pattern è una stringa, il suo contenuto viene utilizzato come delimitatore quando si divide str. Se pattern è un singolo spazio, str viene diviso su spazi bianchi, con spazi bianchi iniziali e sequenze di caratteri di spazi vuoti contigui ignorati.

Se pattern è un'espressione regolare, str è diviso nel punto in cui il pattern corrisponde. Ogni volta che il modello corrisponde a una stringa di lunghezza zero, str viene suddiviso in singoli caratteri.

Se pattern viene omesso, il valore di$; is used. If $; è nil (che è l'impostazione predefinita), str è suddiviso in spazi bianchi come se fosse specificato ``.

Se il parametro limit viene omesso, i campi nulli finali vengono soppressi. Se limite è un numero positivo, verrà restituito al massimo quel numero di campi (se limite è 1, l'intera stringa viene restituita come unica voce in un array). Se negativo, non vi è alcun limite al numero di campi restituiti e i campi nulli finali non vengono soppressi.

str.squeeze([other_str]*)

Crea un set di caratteri dai parametri other_str utilizzando la procedura descritta per String # count. Restituisce una nuova stringa in cui le esecuzioni dello stesso carattere che si verificano in questo set vengono sostituite da un singolo carattere. Se non vengono forniti argomenti, tutte le sequenze di caratteri identici vengono sostituite da un singolo carattere.

str.squeeze!([other_str]*)

Comprime str in posizione, restituendo str o nil se non sono state apportate modifiche.

str.strip

Restituisce una copia di str con gli spazi iniziali e finali rimossi.

str.strip!

Rimuove gli spazi bianchi iniziali e finali da str. Restituisce nil se str non è stato alterato.

str.sub(pattern, replacement) [or]

str.sub(pattern) { |match| block }

Restituisce una copia di str con la prima occorrenza di pattern sostituita con la sostituzione o il valore del blocco. Il pattern sarà tipicamente un Regexp; se è una stringa, non verranno interpretati i metacaratteri delle espressioni regolari.

str.sub!(pattern, replacement) [or]

str.sub!(pattern) { |match| block }

Esegue le sostituzioni di String # sub in posizione, restituendo str o nil se non sono state eseguite sostituzioni.

str.succ [or] str.next

Restituisce il successore a str.

str.succ! [or] str.next!

Equivalente a String # succ, ma modifica il ricevitore in posizione.

str.sum(n = 16)

Restituisce un checksum di base in n bit dei caratteri in str, dove n è il parametro Fixnum opzionale, predefinito a 16. Il risultato è semplicemente la somma del valore binario di ogni carattere in str modulo 2n - 1. Questo non è un particolare buon checksum.

str.swapcase

Restituisce una copia di str con caratteri alfabetici maiuscoli convertiti in caratteri minuscoli e minuscoli convertiti in maiuscoli.

str.swapcase!

Equivalente a String # swapcase, ma modifica il ricevitore in posizione, restituendo str o nil se non sono state apportate modifiche.

str.to_f

> Restituisce il risultato dell'interpretazione dei caratteri iniziali in str come un numero a virgola mobile. I caratteri estranei oltre la fine di un numero valido vengono ignorati. Se non è presente un numero valido all'inizio di str, viene restituito 0.0. Questo metodo non genera mai un'eccezione.

str.to_i(base = 10)

Restituisce il risultato dell'interpretazione dei caratteri iniziali in str come una base intera (base 2, 8, 10 o 16). I caratteri estranei oltre la fine di un numero valido vengono ignorati. Se non c'è un numero valido all'inizio di str, viene restituito 0. Questo metodo non genera mai un'eccezione.

str.to_s [or] str.to_str

Restituisce il ricevitore.

str.tr(from_str, to_str)

Restituisce una copia di str con i caratteri in from_str sostituiti dai caratteri corrispondenti in to_str. Se to_str è più corto di from_str, viene riempito con il suo ultimo carattere. Entrambe le stringhe possono utilizzare la notazione c1.c2 per indicare intervalli di caratteri e from_str può iniziare con ^, che denota tutti i caratteri tranne quelli elencati.

str.tr!(from_str, to_str)

Traduce str in posizione, utilizzando le stesse regole di String # tr. Restituisce str o nil se non sono state apportate modifiche.

str.tr_s(from_str, to_str)

Elabora una copia di str come descritto in String # tr, quindi rimuove i caratteri duplicati nelle aree interessate dalla traduzione.

str.tr_s!(from_str, to_str)

Esegue l'elaborazione String # tr_s su str in posizione, restituendo str o nil se non sono state apportate modifiche.

str.unpack(format)

> Decodifica str (che può contenere dati binari) in base alla stringa di formato, restituendo un array di ogni valore estratto. La stringa di formato consiste in una sequenza di direttive di un carattere, riassunte nella Tabella 18. Ciascuna direttiva può essere seguita da un numero, che indica il numero di volte da ripetere con questa direttiva. Un asterisco (*) utilizzerà tutti gli elementi rimanenti. Ciascuna delle direttive sSiIlL può essere seguita da un trattino basso (_) per utilizzare la dimensione nativa della piattaforma sottostante per il tipo specificato; in caso contrario, utilizza una dimensione coerente indipendente dalla piattaforma. Gli spazi vengono ignorati nella stringa di formato.

str.upcase

Restituisce una copia di str con tutte le lettere minuscole sostituite con le loro controparti maiuscole. L'operazione è insensibile alle impostazioni locali. Sono interessati solo i caratteri dalla a alla z.

str.upcase!

Cambia il contenuto di str in maiuscolo, restituendo nil se non vengono apportate modifiche.

str.upto(other_str) { |s| block }

Scorre i valori successivi, iniziando da str e finendo in other_str incluso, passando ogni valore a turno al blocco. Il metodo String # succ viene utilizzato per generare ogni valore.