2023-02-07 08:13:04 -05:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
declare(strict_types=1);
|
|
|
|
|
|
|
|
|
|
/**
|
2024-05-23 03:26:56 -04:00
|
|
|
* SPDX-FileCopyrightText: 2022 Nextcloud GmbH and Nextcloud contributors
|
|
|
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
2023-02-07 08:13:04 -05:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
namespace OCP\Translation;
|
|
|
|
|
|
|
|
|
|
use RuntimeException;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @since 26.0.0
|
2024-07-26 05:20:46 -04:00
|
|
|
* @deprecated 30.0.0
|
2023-02-07 08:13:04 -05:00
|
|
|
*/
|
|
|
|
|
interface ITranslationProvider {
|
|
|
|
|
/**
|
|
|
|
|
* @since 26.0.0
|
|
|
|
|
*/
|
|
|
|
|
public function getName(): string;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @since 26.0.0
|
|
|
|
|
*/
|
|
|
|
|
public function getAvailableLanguages(): array;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @since 26.0.0
|
|
|
|
|
* @throws RuntimeException If the text could not be translated
|
|
|
|
|
*/
|
|
|
|
|
public function translate(?string $fromLanguage, string $toLanguage, string $text): string;
|
|
|
|
|
}
|