Java String valueOf() metodas

Skaičiaus pavertimas tekstu

int taskai = 42;
String tekstas = String.valueOf(taskai);

System.out.println(tekstas);
System.out.println(tekstas + " taškai");

1. Kintamasis taskai yra int tipo skaičius.
2. String.valueOf(taskai) sukuria tekstinę šio skaičiaus išraišką.
3. Rezultatas saugomas String kintamajame tekstas.
4. Nuo šios vietos reikšmę galima jungti su kitu tekstu kaip įprastą String.

Kodėl valueOf() yra statinis metodas?

valueOf() kviečiamas per klasę String, nes metodas kuria tekstą iš perduotos reikšmės ir jam nereikia jau turimo String objekto:

Kairėje esantis String yra rezultato tipas. String prieš tašką yra klasė, kuriai priklauso statinis metodas.

Metodo sintaksė

Nors metodas turi daug perkrovų, mokantis svarbiausia idėja viena: perduota reikšmė paverčiama į naują String.

Primityviųjų reikšmių pavertimas

boolean aktyvus = true;
char raide = 'J';
double kaina = 3.99;

System.out.println(String.valueOf(aktyvus));
System.out.println(String.valueOf(raide));
System.out.println(String.valueOf(kaina));

• boolean reikšmė tampa tekstu true arba false.
• char reikšmė tampa vieno simbolio String.
• Skaičius tampa tekstine skaičiaus išraiška, bet tai nėra skaičių formatavimo metodas.

Objekto pavertimas tekstu

class Vartotojas {
  private final String vardas;

  Vartotojas(String vardas) {
    this.vardas = vardas;
  }

  @Override
  public String toString() {
    return "Vartotojas: " + vardas;
  }
}

Vartotojas vartotojas = new Vartotojas("Ieva");
String tekstas = String.valueOf(vartotojas);

System.out.println(tekstas);

Kai perduodamas objektas, String.valueOf(objektas) naudoja objekto toString() rezultatą. Dėl to klasėse verta perrašyti toString(), jei objektai bus rodomi tekstu, žurnaluose ar diagnostikoje.

null pavertimas tekstu

Object pasirinkimas = null;
String tekstas = String.valueOf(pasirinkimas);

System.out.println(tekstas);

Jei Object reikšmė yra null, String.valueOf() nesukelia NullPointerException. Vietoje to metodas grąžina tekstą null. Tai skiriasi nuo tiesioginio pasirinkimas.toString(), kuris per null nuorodą neveiktų.

char masyvo pavertimas tekstu

char[] raides = {'J', 'a', 'v', 'a'};
String tekstas = String.valueOf(raides);

System.out.println(tekstas);

Su char[] masyvu valueOf() veikia panašiai kaip copyValueOf(): simboliai nukopijuojami į naują nekintamą String.

Tik dalies char masyvo pavertimas

char[] zinute = {'K', 'u', 'r', 's', 'a', 's', ':', ' ', 'J', 'a', 'v', 'a'};
String dalis = String.valueOf(zinute, 8, 4);

System.out.println(dalis);

1. Masyve yra tekstas Kursas: Java.
2. offset reikšmė 8 nurodo pradėti nuo simbolio J.
3. count reikšmė 4 nurodo paimti keturis simbolius.
4. Rezultatas yra naujas tekstas Java.

valueOf() ir jungimas su tuščiu tekstu

int lygis = 5;

String suTusciuTekstu = "" + lygis;
String suValueOf = String.valueOf(lygis);

System.out.println(suTusciuTekstu);
System.out.println(suValueOf);

Abi eilutės duoda tą patį matomą rezultatą, tačiau String.valueOf(lygis) aiškiau pasako, kad tikslas yra reikšmės pavertimas tekstu. Tuščio teksto jungimas dažnai atsiranda greituose pavyzdžiuose, bet mokomajame ar komandos kode aiškus metodas lengviau skaitomas.

valueOf() nėra formatavimas

String.valueOf() sukuria paprastą tekstinę reikšmės išraišką. Jei reikia kontroliuoti skaitmenų po kablelio kiekį, lygiavimą, procentus ar lokalę, naudok String.format().

Dažnos klaidos

char[] raides = {'J', 'a', 'v', 'a'};
String tekstas = String.valueOf(raides, 2, 5);

System.out.println(tekstas);

• Su char[] dalimi offset + count peržengia masyvo ribas.
• Neigiamas offset arba count yra netinkamas.
• Tikimasi specialaus skaičių formatavimo, nors valueOf() tik paverčia reikšmę tekstu.
• Manoma, kad null objektas bus tuščias tekstas, nors rezultatas yra null.
• Objektas neturi prasmingo toString(), todėl gaunamas techninis klasės pavadinimas ir hash reikšmė.

Kada naudoti String.valueOf()?

String.valueOf() naudok tada, kai reikia aiškiai paversti reikšmę į String: ruošiant tekstą išvedimui, jungiant reikšmes su tekstu, saugant paprastą tekstinę formą arba saugiai apdorojant galimą null objektą.