A Função new()

Parte da seção Programação Orientada a Objetos do Journey de GO da Coddy — lição 22 de 107.

Go fornece uma função integrada chamada new() que aloca memória para um tipo e retorna um ponteiro para ele. A memória alocada é inicializada com o valor zero do tipo.

p := new(int)      // aloca memória para um int
fmt.Println(*p)    // 0 (valor zero)
fmt.Println(p)     // 0xc000018030 (endereço de memória)

A função new() recebe um tipo como seu argumento e retorna um ponteiro para um valor zero recém-alocado desse tipo. Isso é particularmente útil quando você precisa de um ponteiro, mas não tem uma variável existente para referenciar.

Com structs, new() cria um ponteiro para uma struct com todos os campos definidos para seus valores zero.

type Person struct {
    Name string
    Age  int
}

p := new(Person)
fmt.Println(p.Name)  // "" (string vazia)
fmt.Println(p.Age)   // 0

Você pode se perguntar quando usar new() em vez do operador de endereço &. Ambas as abordagens abaixo são equivalentes:

// Usando new()
p1 := new(Person)

// Usando o operador de endereço com literal
p2 := &Person{}

A sintaxe &Person{} é mais comum na prática porque permite inicializar campos ao mesmo tempo. Use new() quando você deseja especificamente uma instância com valor zero e prefere semânticas explícitas de alocação de memória.

Desafio

Fácil

Vamos construir um gerenciador de configuração que demonstra como o new() aloca memória e inicializa structs com seus valores zero. Você verá como essa abordagem difere do uso do operador de endereço com um literal de struct.

Você organizará seu código em dois arquivos:

config.go: Defina uma struct ServerConfig com os campos Host (string), Port (int), MaxConnections (int) e DebugMode (bool). Crie duas funções:
- NewServerConfig que usa new() para alocar um ServerConfig e retorna o ponteiro diretamente (com todos os valores zero)
- ConfigureServer que recebe um ponteiro *ServerConfig junto com uma string host e um inteiro port, e então define esses campos na configuração através do ponteiro
Também adicione um método Display em *ServerConfig que retorna uma string formatada mostrando todos os valores de configuração.
main.go: Leia um host e uma porta da entrada. Primeiro, crie uma configuração usando NewServerConfig() e exiba-a para mostrar os valores zero. Em seguida, use ConfigureServer para definir o host e a porta, e exiba a configuração novamente para mostrar os valores atualizados.

As seguintes entradas serão fornecidas:

Linha 1: Nome do host (string)
Linha 2: Número da porta (inteiro)

Seu método Display deve retornar uma string neste formato exato:

Host: [Host]
Port: [Port]
MaxConnections: [MaxConnections]
DebugMode: [DebugMode]

Imprima a saída do display duas vezes — uma antes de configurar (mostrando os valores zero) e outra após configurar (mostrando o host e a porta atualizados).

Por exemplo, dados localhost e 8080, sua saída deve ser:

Host: 
Port: 0
MaxConnections: 0
DebugMode: false
Host: localhost
Port: 8080
MaxConnections: 0
DebugMode: false

Observe como a primeira exibição mostra todos os valores zero (string vazia, 0, 0, false) porque o new() inicializa tudo com valores zero. Após chamar ConfigureServer, apenas o host e a porta mudam, enquanto os outros campos permanecem em seus valores zero.

Folha de consulta

A função new() aloca memória para um tipo e retorna um ponteiro para ele, inicializado com o valor zero do tipo:

p := new(int)      // aloca memória para um int
fmt.Println(*p)    // 0 (valor zero)
fmt.Println(p)     // 0xc000018030 (endereço de memória)

Com structs, new() cria um ponteiro para uma struct com todos os campos definidos para seus valores zero:

type Person struct {
    Name string
    Age  int
}

p := new(Person)
fmt.Println(p.Name)  // "" (string vazia)
fmt.Println(p.Age)   // 0

Usar new() versus o operador de endereço & - ambos são equivalentes:

// Usando new()
p1 := new(Person)

// Usando o operador de endereço com literal
p2 := &Person{}

A sintaxe &Person{} é mais comum porque permite a inicialização de campos no momento da criação. Use new() quando desejar uma instância com valor zero com semântica de alocação de memória explícita.

Experimente você mesmo

package main

import (
	"fmt"
)

func main() {
	// Ler entrada
	var host string
	var port int
	fmt.Scanln(&host)
	fmt.Scanln(&port)

	// TODO: Criar uma configuração usando NewServerConfig() e exibi-la
	// Isso mostrará os valores zero

	// TODO: Usar ConfigureServer para definir o host e a porta

	// TODO: Exibir a configuração novamente para mostrar os valores atualizados
}