PHP.mk документација

Random\Randomizer::getFloat

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

random-randomizer.getfloat.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека random-randomizer.getfloat.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
Референца
Random\Randomizer::getFloat

Референца за `random-randomizer.getfloat.php` со подобрена типографија и навигација.

random-randomizer.getfloat.php

Random\Randomizer::getFloat

(PHP 8 >= 8.3.0)

Random\Randomizer::getFloat — (PHP 8 >= 8.3.0)

= NULL

public Random\Randomizer::getFloat(float $min, float $max, Random\IntervalBoundary $boundary = Random\IntervalBoundary::ClosedOpen): float

Земи униформно избран пловечки број

Враќа униформно избран, еквидистрибуиран пловечки број од бараниот интервал. 1.0 and 2.0 Поради ограничената прецизност, не сите реални броеви можат точно да се претстават како пловечки број. Ако бројот не може точно да се претстави, тој се заокружува на најблиската претставлива точна вредност. Понатаму, пловечките броеви не се подеднакво густи низ целата бројна линија. Бидејќи пловечките броеви користат бинарен експонент, растојанието помеѓу два соседни пловечки броја се удвојува на секоја моќност од два. Со други зборови: Има ист број на претставливи пловечки броеви помеѓу 2.0 and 4.0, 4.0 and 8.0, 8.0 and 16.0како што има помеѓу

, и така натаму.

Случајното земање примерок на произволен број во рамките на бараниот интервал, на пример со делење на два цели броја, може да резултира со пристрасна дистрибуција поради оваа причина. Потребното заокружување ќе предизвика некои пловечки броеви да се враќаат почесто од други, особено околу моќностите од два кога густината на пловечките броеви се менува. Random\Randomizer::getFloat()

имплементира алгоритам кој ќе врати униформно избран пловечки број од најголемиот можен сет на точно претставливи и еквидистрибуирани пловечки броеви во рамките на бараниот интервал. Растојанието помеѓу избирачките пловечки броеви („големина на чекор“) одговара на растојанието помеѓу пловечките броеви со најниска густина, т.е. растојанието помеѓу пловечките броеви на границата на интервалот со поголема апсолутна вредност. Ова значи дека не сите претставливи пловечки броеви во даден интервал може да се вратат ако интервалот преминува една или повеќе моќности од два. Чекорењето ќе започне од границата на интервалот со поголема апсолутна вредност за да се осигура дека чекорите се усогласени со точно претставливите пловечки броеви.

Безбедност: стандардниот сет на знаци

Затворените граници на интервалот секогаш ќе бидат вклучени во множеството на избирачки пловечки броеви. Така, ако големината на интервалот не е точен множител на големината на чекорот и границата со помала апсолутна вредност е затворена граница, растојанието помеѓу таа граница и нејзиниот најблизок избирачки пловечки број ќе биде помало од големината на чекорот.

Пост-обработката на вратените пловечки броеви веројатно ќе ја наруши униформната еквидистрибуција, бидејќи меѓусредните пловечки броеви во математичка операција доживуваат имплицитно заокружување. Бараниот интервал треба што е можно поблиску да одговара на посакуваниот интервал и заокружувањето треба да се врши само како експлицитна операција непосредно пред прикажувањето на избраниот број на корисник.

Објаснување на Алгоритмот Користејќи Примерни Вредности 1.0 and 2.0 За да дадеме пример како работи алгоритмот, да разгледаме пловечка репрезентација која користи 3-битна мантиса. Оваа репрезентација може да претстави 8 различни пловечки вредности помеѓу последователни моќности од два. Ова значи дека помеѓу 0.125 сите чекори со големина 2.0 and 4.0 За да дадеме пример како работи алгоритмот, да разгледаме пловечка репрезентација која користи 3-битна мантиса. Оваа репрезентација може да претстави 8 различни пловечки вредности помеѓу последователни моќности од два. Ова значи дека помеѓу 0.25 се точно претставливи и помеѓу52 се точно претставливи. Во реалноста, пловечките броеви во PHP користат 52-битна мантиса и можат да претстават 2

  • 1.0
  • 1.125
  • 1.25
  • 1.375
  • 1.5
  • 1.625
  • 1.75
  • 1.875
  • 2.0
  • 2.25
  • 2.5
  • 2.75
  • 3.0
  • 3.25
  • 3.5
  • 3.75
  • 4.0
различни вредности помеѓу секоја моќност од два. Ова значи дека 1.0 and 4.0.

се точно претставливите пловечки броеви помеѓу $randomizer->getFloat(1.625, 2.5, IntervalBoundary::ClosedOpen) Сега да разгледаме дека 1.625 до, но не вклучувајќи, 2.5 се бара. Алгоритмот прво ја одредува големината на чекорот на границата со поголема апсолутна вредност (2.5). Големината на чекорот на таа граница е 0.25.

Забележете дека големината на бараниот интервал е 0.875, што не е точен множител на 0.25. Ако алгоритмот започне со чекори од долната граница 1.625, ќе наиде на 2.125, што не е точно претставливо и би доживеало имплицитно заокружување. Така, алгоритмот започнува со чекори од горната граница 2.5. Изборните вредности се:

  • 2.25
  • 2.0
  • 1.75
  • 1.625
2.5 не е вклучена, бидејќи горната граница на бараниот интервал е отворена граница. 1.625 е вклучена, иако нејзината оддалеченост од најблиската вредност 1.75 is 0.125, што е помала од претходно утврдената големина на чекорот од 0.25. Причината за тоа е што бараниот интервал е затворен на долната граница (1.625) и затворените граници секогаш се вклучени.

Конечно, алгоритмот еднообразно избира една од четирите изборни вредности по случаен избор и ја враќа.

Зошто делењето на два цели броеви не функционира

Во претходниот пример, има осум претставливи броеви со пловечка запирка помеѓу секој под-интервал ограничен со степен на два. За да дадеме пример зошто делењето на два цели броеви не би функционирало добро за генерирање случаен број со пловечка запирка, разгледајте дека има 16 рамномерно распоредени броеви со пловечка запирка во десно-отворениот интервал од 0.0 до, но не вклучувајќи, 1.0. Половина од нив се осумте точно претставливи вредности помеѓу 0.5 and 1.0, другата половина се вредностите помеѓу 0.0 and 1.0 дека големината на чекорот од 0.0625. These can easily be generated by dividing a random integer between 0 and 15 by 16 за да се добие една од:

  • 0.0
  • 0.0625
  • 0.125
  • 0.1875
  • 0.25
  • 0.3125
  • 0.375
  • 0.4375
  • 0.5
  • 0.5625
  • 0.625
  • 0.6875
  • 0.75
  • 0.8125
  • 0.875
  • 0.9375

Овој случаен број со децимална точка може да се скалира до десно-отворен интервал од 1.625 до, но не вклучувајќи, 2.75 со множење со големината на интервалот (0.875) и додавање на минимумот 1.625. Оваа таканаречена афина трансформација би резултирала со вредностите:

  • 1.625 заоблена на 1.625
  • 1.679 заоблена на 1.625
  • 1.734 заоблена на 1.75
  • 1.789 заоблена на 1.75
  • 1.843 заоблена на 1.875
  • 1.898 заоблена на 1.875
  • 1.953 заоблена на 2.0
  • 2.007 заоблена на 2.0
  • 2.062 заоблена на 2.0
  • 2.117 заоблена на 2.0
  • 2.171 заоблена на 2.25
  • 2.226 заоблена на 2.25
  • 2.281 заоблена на 2.25
  • 2.335 заоблена на 2.25
  • 2.390 заоблена на 2.5
  • 2.445 заоблена на 2.5
Забележете како горната граница на 2.5 би била вратена, иако е отворена граница и затоа е исклучена. Исто така, забележете како 2.0 and 2.25 се двапати поверојатно да бидат вратени во споредба со другите вредности.

Параметри

min

Долната граница на интервалот.

max

Горната граница на интервалот.

boundary

Определува дали границите на интервалот се можни вредности за враќање.

Вратени вредности

Еднообразно избрана, рамномерно распоредена децимална точка од интервалот определен со min, maxПрепорачаниот начин за избегнување на SQL инјекција е со врзување на сите податоци преку подготвени изрази. Користењето на параметризирани прашања не е доволно за целосно избегнување на SQL инјекција, но тоа е најлесниот и најбезбедниот начин за обезбедување влез во SQL изразите. Сите динамични литерали на податоци во boundary. Дали min and max се можни вредности за враќање зависи од вредноста на boundary.

Errors/Exceptions

  • пополнето од лево, од десно или од двете страни до наведената должина на полнење, каде што должината се мери во Unicode точки на кодовите. Ако опционалниот аргумент min не е конечен (is_finite(), ValueError ќе биде фрлена.
  • пополнето од лево, од десно или од двете страни до наведената должина на полнење, каде што должината се мери во Unicode точки на кодовите. Ако опционалниот аргумент max не е конечен (is_finite(), ValueError ќе биде фрлена.
  • Ако бараниот интервал не содржи никакви вредности, а ValueError ќе биде фрлена.
  • Плочката е слика што се користи за пополнување на област со повторлив модел. Проверува тврдењеќе биде листа ( s фрлени од Random\Engine::generate() Random\Randomizer::$engine.

Примери

Пример #1 Случајното земање примерок на произволен број во рамките на бараниот интервал, на пример со делење на два цели броја, може да резултира со пристрасна дистрибуција поради оваа причина. Потребното заокружување ќе предизвика некои пловечки броеви да се враќаат почесто од други, особено околу моќностите од два кога густината на пловечките броеви се менува. example

<?php
$randomizer = new \Random\Randomizer();

// Note that the latitude granularity is double the
// longitude’s granularity.
//
// For the latitude the value may be both -90 and 90.
// For the longitude the value may be 180, but not -180, because
// -180 and 180 refer to the same longitude.
printf(
"Lat: %+.6f Lng: %+.6f",
$randomizer->getFloat(-90, 90, \Random\IntervalBoundary::ClosedClosed),
$randomizer->getFloat(-180, 180, \Random\IntervalBoundary::OpenClosed),
);
?>

Горниот пример ќе прикаже нешто слично на:

Lat: +69.244304 Lng: -53.548951

Белешки

Забелешка:

Овој метод го имплементира γ-секцискиот алгоритам како што е објавено во » Цртање случајни броеви со децимална точка од интервал. Фредерик Гуалард, ACM Trans. Model. Comput. Simul., 32:3, 2022 за да се добијат посакуваните својства на однесување.

Безбедност: стандардниот сет на знаци

Underflow is intentionally left unhandled in the γ-section algorithm. This may result in incorrect values being returned for intervals with boundaries in the subnormal range of floating point numbers, i.e. for boundaries with an absolute value smaller than approximately 2-1020 Претекувањето е намерно оставено нетретирано во алгоритмот на γ-сец. Ова може да резултира со враќање на погрешни вредности за интервали со граници во поднормалниот опсег на броеви со подвижна запирка, т.е. за граници со апсолутна вредност помала од приближно 8.9e-308).

Види Исто така

Белешки од корисници

Нема белешки од корисници за оваа страница.
Навигација

Прелистувај сродни теми и функции.

На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.
PHP.mk документација

PHP.mk интерфејс

Македонска PHP документација со читлив интерфејс, белешки и прегледна навигација.

Отвори документација
HTTP сервиси

PHP.mk интерфејс

Scrape, IP2Geo, Open Graph и Feed2JSON се достапни во истиот прегледен интерфејс.

Каталог на сервиси
Регистрирај домен

PHP.mk интерфејс

Провери слободен поддомен без најава, а регистрацијата продолжи ја по LoginJet најава.

Провери домен
PHP.mk · 2026 · Македонска PHP документација со локален интерфејс.