Интерфейс fs.FileInfo

Интерфейс fs.FileInfo представляет информацию о файле или директории. Он содержит методы для получения имени файла, его размера, времени последнего изменения, режима доступа и определения, является ли объект директорией. Этот интерфейс часто возвращается функциями os.Stat, os.Lstat и os.File.Stat.

Методы интерфейса

Интерфейс fs.FileInfo содержит следующие методы:

• Name() string - возвращает имя файла (без пути)
• Size() int64 - возвращает размер файла в байтах
• Mode() fs.FileMode - возвращает режим доступа и тип файла
• ModTime() time.Time - возвращает время последнего изменения
• IsDir() bool - возвращает true, если объект является директорией
• Sys() any - возвращает системно-зависимые данные о файле

Базовый пример использования

Получим информацию о существующем файле с помощью функции os.Stat:

gopackage main

import (
  "fmt"
  "os"
)

func main() {
  info, err := os.Stat("example.txt")
  if err != nil {
    fmt.Println("Error:", err)
    return
  }

  fmt.Println("Name:", info.Name())
  fmt.Println("Size:", info.Size())
  fmt.Println("IsDir:", info.IsDir())
  fmt.Println("ModTime:", info.ModTime())
  fmt.Println("Mode:", info.Mode())
}

Результат выполнения кода (для существующего файла):

goName: example.txt
Size: 1024
IsDir: false
ModTime: 2026-09-04 12:34:56 +0000 UTC
Mode: -rw-r--r--

Определение типа объекта

Проверим, является ли объект файлом или директорией, с помощью метода IsDir:

gopackage main

import (
  "fmt"
  "os"
)

func main() {
  info, err := os.Stat("testdir")
  if err != nil {
    fmt.Println("Error:", err)
    return
  }

  if info.IsDir() {
    fmt.Println("testdir is a directory")
  } else {
    fmt.Println("testdir is a file")
  }
}

Результат выполнения кода:

gotestdir is a directory

Проверка режима доступа

Метод Mode возвращает режим доступа к файлу. Проверим наличие прав на запись:

gopackage main

import (
  "fmt"
  "os"
)

func main() {
  info, err := os.Stat("example.txt")
  if err != nil {
    fmt.Println("Error:", err)
    return
  }

  mode := info.Mode()
  if mode&0200 != 0 {
    fmt.Println("File is writable by owner")
  } else {
    fmt.Println("File is not writable by owner")
  }
}

Результат выполнения кода:

goFile is writable by owner

Получение информации о временном файле

Создадим временный файл и получим его информацию:

gopackage main

import (
  "fmt"
  "os"
)

func main() {
  file, err := os.CreateTemp("", "temp-*.txt")
  if err != nil {
    fmt.Println("Error:", err)
    return
  }
  defer os.Remove(file.Name())
  defer file.Close()

  info, err := file.Stat()
  if err != nil {
    fmt.Println("Error:", err)
    return
  }

  fmt.Println("Temp file name:", info.Name())
  fmt.Println("Temp file size:", info.Size())
}

Результат выполнения кода:

goTemp file name: temp-123456789.txt
Temp file size: 0

Смотрите также