sqlite_udf_decode_binary

(PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)

sqlite_udf_decode_binaryДекодирует бинарные данные, переданные в качестве параметров в UDF

Описание

sqlite_udf_decode_binary ( string $data ) : string

Декодирует бинарные данные, переданные в качестве параметров в UDF.

Функцию следует применять к аргументам, переданным в UDF, если в этих аргументах могут содержаться бинарные данные.

PHP не осуществляет данные операции кодирования и декодирования автоматически, так как это негативно сказывается на производительности.

Список параметров

data

Закодированные данные, которые будут раскодированы. Кодирование должно было быть осуществлено с помощью функций sqlite_udf_encode_binary() или sqlite_escape_string().

Возвращаемые значения

Декодированная строка (string).

Примеры

Пример #1 Пример реализации агрегирующей функции max_length, способной работать с бинарными данными

<?php
$data 
= array(
   
'one',
   
'two',
   
'three',
   
'four',
   
'five',
   
'six',
   
'seven',
   
'eight',
   
'nine',
   
'ten',
   );
$db sqlite_open(':memory:');
sqlite_query($db"CREATE TABLE strings(a)");
foreach (
$data as $str) {
    
$str sqlite_escape_string($str);
    
sqlite_query($db"INSERT INTO strings VALUES ('$str')");
}

function 
max_len_step(&$context$string
{
    
$string sqlite_udf_decode_binary($string);
    if (
strlen($string) > $context) {
        
$context strlen($string);
    }
}

function 
max_len_finalize(&$context
{
    return 
$context;
}

sqlite_create_aggregate($db'max_len''max_len_step''max_len_finalize');

var_dump(sqlite_array_query($db'SELECT max_len(a) from strings'));

?>

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

  • sqlite_udf_encode_binary() - Кодирует бинарные данные перед тем как вернуть их из UDF
  • sqlite_create_function() - Регистрирует "стандартную" функцию (UDF) для использования в SQL-запросах
  • sqlite_create_aggregate() - Регистрирует агрегирующую функцию для использования в SQL-запросах

add a note add a note

User Contributed Notes 1 note

up
1
BenWa
6 years ago
I had to migrate an existing SQLITE2 db with UDF encoded fields. SQLITE3 does not support sqlite_udf_decode_binary. So I wrote a replacement for the migration.

    function sqlite_udf_decode_binary($in){
      if ( substr($in,0,1)==chr(1) ) {
        $n=strlen($in);
        $e=ord(substr($in,1,1));
        $i=2 ;
        while($i<$n){
            $x = ord(substr($in,$i,1)) ;
            if ($x==1) {
                $i++;
                $x = ord(substr($in,$i,1)) - 1 ;
            }
            $out .= chr($x+$e) ;
            $i++;
        }
         
      } else {
          $out = $in ;
      }
      return $out ;
    }
To Top