Home / Edit Entity:IsValid

Log in to edit

Entity:IsValid

<function name="IsValid" parent="Entity" type="classfunc">
	<description>
Returns whether the entity is a valid entity or not.

An entity is valid if:
* It is not a <page text="NULL">Global_Variables</page> entity
* It is not the worldspawn entity (<page>game.GetWorld</page>)

<note>Instead of calling this method directly, it's a good idea to call the global <page>Global.IsValid</page> instead, however if you're sure the variable you're using is always an entity object it's better to use this method</note>

It will check whether the given variable contains an object (an Entity) or nothing at all for you. See examples.

<warning>NULL entities can still be assigned with key/value pairs, but they will be instantly negated. See example 3</warning>
This might be a cause for a lot of headache. Usually happening during networking etc., when completely valid entities suddenly become invalid on the client, but are never filtered with IsValid(). See <page>GM:InitPostEntity</page> for more details.
	</description>
	<realm>Shared</realm>
	<rets>
		<ret name="" type="boolean">true if the entity is valid, false otherwise</ret>
	</rets>
</function>

<example>
	<description>Shows how to use the global <page>Global.IsValid</page> function instead of using this method directly.</description>
	<code>
if ( entity && entity:IsValid() ) then
	-- Do stuff
end

-- The above can be replaced with the following for the same effect (and cleaner code)

if ( IsValid( entity ) ) then
	-- Do stuff
end
	</code>

</example>


<example>
	<code>print( LocalPlayer():IsValid() )</code>
	<output>Outputs 'true' to the console if the player is in-game.</output>

</example>


<example>
	<code>
local newPlayer = net.ReadEntity() --server found a new player on the server and sent it to us after 
print( "1/4" )              -- it determined it was valid (newPlayer is NULL in this realm)

if not isnumber(newPlayer.ImportantGameData) then --If it doesn't have a specific field, assign a value to it
	print( "2/4" )
	newPlayer.ImportantGameData = 42 
end
print( "3/4" )

print( newPlayer.ImportantGameData * 69 ) --Attempting to do arithmetics on the new field
print( "4/4" )
	</code>
	<output>
1/4 ... 3/4
* A lua error telling us 'ImportantGameData' is a nil value and thus can't perform math on it
----
But this shouldn't be possible, because we just created a value there. No red flags are present up until this point; all code up until this will run fine. Make sure to add an IsValid() check when the seemingly impossible happens.
	</output>

</example>

Garry's Mod Wiki

Player Guides

Getting Started 13

Sandbox Tools 3

Game Modes 5

Server Hosting 9

Other Topics 8

Developer Guides

Getting Started 10

Lua Programming 28

Game Systems 10

Gamemode Creation 5

HUD and User Interface 15

Scripted Entities and Weapons 9

NPCs and AI 2

Map and Level Design 6

Models, Textures and Animation 7

Addons and Steam Workshop 4

Binary Modules 6

Other Topics 15

Developer Reference

Globals 329

Classes 46

Libraries 88

achievements
- BalloonPopped
- Count
- EatBall
- GetCount
- GetDesc
- GetGoal
- GetName
- IncBaddies
- IncBystander
- IncGoodies
- IsAchieved
- Remover
- SpawnedNPC
- SpawnedProp
- SpawnedRagdoll
- SpawnMenuOpen
ai
ai_schedule
- New
ai_task
- New
baseclass
- Get
- Set
bit
- arshift
- band
- bnot
- bor
- bswap
- bxor
- lshift
- rol
- ror
- rshift
- tobit
- tohex
cam
- ApplyShake
- End
- End2D
- End3D
- End3D2D
- EndOrthoView
- GetModelMatrix
- IgnoreZ
- PopModelMatrix
- PushModelMatrix
- Start
- Start2D
- Start3D
- Start3D2D
- StartOrthoView
chat
- AddText
- Close
- GetChatBoxPos
- GetChatBoxSize
- Open
- PlaySound
cleanup
- Add
- CC_AdminCleanup
- CC_Cleanup
- GetList
- GetTable
- Register
- ReplaceEntity
- UpdateUI
concommand
- Add
- AutoComplete
- GetTable
- Remove
- Run
constraint
construct
- Magnet
- SetPhysProp
controlpanel
- Clear
- Get
cookie
- Delete
- GetNumber
- GetString
- Set
coroutine
- create
- isyieldable
- resume
- running
- status
- wait
- wrap
- yield
cvars
debug
- debug
- getfenv
- gethook
- getinfo
- getlocal
- getmetatable
- getregistry
- getupvalue
- setfenv
- sethook
- setlocal
- setmetatable
- setupvalue
- Trace
- traceback
- upvalueid
- upvaluejoin
debugoverlay
- Axis
- Box
- BoxAngles
- Cross
- EntityTextAtPosition
- Grid
- Line
- ScreenText
- Sphere
- SweptBox
- Text
- Triangle
derma
dragndrop
draw
- DrawText
- GetFontHeight
- NoTexture
- RoundedBox
- RoundedBoxEx
- SimpleText
- SimpleTextOutlined
- Text
- TextShadow
- TexturedQuad
- WordBox
drive
- CalcView
- CreateMove
- DestroyMethod
- End
- FinishMove
- GetMethod
- Move
- PlayerStartDriving
- PlayerStopDriving
- Register
- Start
- StartMove
duplicator
effects
- BeamRingPoint
- Bubbles
- BubbleTrail
- Create
- GetList
- Register
engine
ents
file
- Append
- AsyncRead
- CreateDir
- Delete
- Exists
- Find
- IsDir
- Open
- Read
- Rename
- Size
- Time
- Write
frame_blend
game
gameevent
- Listen
gamemode
- Call
- Get
- Register
gmod
- GetGamemode
gmsave
gui
GWEN
halo
hammer
- SendCommand
hook
- Add
- Call
- GetTable
- Remove
- Run
http
- Fetch
- Post
input
jit
- opt
  - start
- util
  - funcbc
  - funcinfo
  - funck
  - funcuvname
  - ircalladdr
  - traceexitstub
  - traceinfo
  - traceir
  - tracek
  - tracemc
  - tracesnap
- arch
- os
- version
- version_num
- attach
- flush
- off
- on
- status
killicon
- Add
- AddAlias
- AddFont
- AddTexCoord
- Draw
- Exists
- GetSize
- Render
language
- Add
- GetPhrase
list
- Add
- Contains
- Get
- GetEntry
- GetForEdit
- GetTable
- HasEntry
- Set
markup
- Color
- Escape
- Parse
math
- ease
  - InBack
  - InBounce
  - InCirc
  - InCubic
  - InElastic
  - InExpo
  - InOutBack
  - InOutBounce
  - InOutCirc
  - InOutCubic
  - InOutElastic
  - InOutExpo
  - InOutQuad
  - InOutQuart
  - InOutQuint
  - InOutSine
  - InQuad
  - InQuart
  - InQuint
  - InSine
  - OutBack
  - OutBounce
  - OutCirc
  - OutCubic
  - OutElastic
  - OutExpo
  - OutQuad
  - OutQuart
  - OutQuint
  - OutSine
- huge
- pi
- tau
- abs
- acos
- AngleDifference
- Approach
- ApproachAngle
- asin
- atan
- atan2
- BinToInt
- BSplinePoint
- calcBSplineN
- ceil
- CHSpline
- Clamp
- cos
- cosh
- CubicBezier
- deg
- Dist
- Distance
- DistanceSqr
- EaseInOut
- exp
- Factorial
- floor
- fmod
- frexp
- IntToBin
- IsNearlyEqual
- ldexp
- log
- log10
- max
- min
- mod
- modf
- NormalizeAngle
- pow
- QuadraticBezier
- rad
- Rand
- random
- randomseed
- Remap
- Round
- sin
- sinh
- SnapTo
- sqrt
- tan
- tanh
- TimeFraction
- Truncate
matproxy
- ActiveList
- ProxyList
- Add
- Call
- Init
- ShouldOverrideProxy
menu
- RecordFrame
menubar
- Init
- IsParent
- ParentTo
mesh
- AdvanceVertex
- Begin
- Color
- End
- Normal
- Position
- Quad
- QuadEasy
- Specular
- TangentS
- TangentT
- TexCoord
- UserData
- VertexCount
motionsensor
navmesh
net
- ReadVars
- Receivers
- WriteVars
- Abort
- Broadcast
- BytesLeft
- BytesWritten
- Incoming
- ReadAngle
- ReadBit
- ReadBool
- ReadColor
- ReadData
- ReadDouble
- ReadEntity
- ReadFloat
- ReadHeader
- ReadInt
- ReadMatrix
- ReadNormal
- ReadPlayer
- ReadString
- ReadTable
- ReadType
- ReadUInt
- ReadUInt64
- ReadVector
- Receive
- Send
- SendOmit
- SendPAS
- SendPVS
- SendToServer
- Start
- WriteAngle
- WriteBit
- WriteBool
- WriteColor
- WriteData
- WriteDouble
- WriteEntity
- WriteFloat
- WriteInt
- WriteMatrix
- WriteNormal
- WritePlayer
- WriteString
- WriteTable
- WriteType
- WriteUInt
- WriteUInt64
- WriteVector
notification
numpad
- Activate
- Deactivate
- FromButton
- OnDown
- OnUp
- Register
- Remove
- Toggle
os
- clock
- date
- difftime
- time
package
- loaded
- seeall
permissions
- AskToConnect
- Connect
- EnableVoiceChat
- GetAll
- Grant
- IsGranted
- Revoke
physenv
player
- CreateNextBot
- GetAll
- GetBots
- GetByAccountID
- GetByID
- GetBySteamID
- GetBySteamID64
- GetByUniqueID
- GetCount
- GetHumans
- Iterator
player_manager
presets
- Add
- BadNameAlert
- Exists
- GetTable
- OverwritePresetPrompt
- Remove
- Rename
properties
- List
- Add
- CanBeTargeted
- GetHovered
- OnScreenClick
- OpenEntityMenu
- Remove
render
resource
saverestore
- AddRestoreHook
- AddSaveHook
- LoadEntity
- LoadGlobal
- PreRestore
- PreSave
- ReadTable
- ReadVar
- SaveEntity
- SaveGlobal
- WritableKeysInTable
- WriteTable
- WriteVar
scripted_ents
- Alias
- Get
- GetList
- GetMember
- GetSpawnable
- GetStored
- GetType
- IsBasedOn
- OnLoaded
- Register
search
- AddProvider
- GetResults
serverlist
sound
- Add
- AddSoundOverrides
- EmitHint
- Generate
- GetLoudestSoundHint
- GetProperties
- GetTable
- Play
- PlayFile
- PlayURL
- SetActorGender
spawnmenu
sql
- Begin
- Commit
- IndexExists
- LastError
- Query
- QueryRow
- QueryValue
- SQLStr
- TableExists
steamworks
string
- byte
- CardinalToOrdinal
- char
- Comma
- dump
- EndsWith
- Explode
- find
- format
- FormattedTime
- FromColor
- GetChar
- GetExtensionFromFilename
- GetFileFromFilename
- GetPathFromFilename
- gfind
- gmatch
- gsub
- Implode
- Interpolate
- JavascriptSafe
- Left
- len
- lower
- match
- NiceName
- NiceSize
- NiceTime
- PatternSafe
- rep
- Replace
- reverse
- Right
- SetChar
- Split
- StartsWith
- StartWith
- StripExtension
- sub
- ToColor
- ToMinutesSeconds
- ToMinutesSecondsMilliseconds
- ToTable
- Trim
- TrimLeft
- TrimRight
- upper
surface
system
- AppTime
- BatteryPower
- FlashWindow
- GetCountry
- HasFocus
- IsLinux
- IsOSX
- IsWindowed
- IsWindows
- SteamTime
- UpTime
table
- Add
- ClearKeys
- CollapseKeyValue
- concat
- Copy
- CopyFromTo
- Count
- DeSanitise
- Empty
- FindNext
- FindPrev
- Flip
- ForceInsert
- foreach
- foreachi
- GetFirstKey
- GetFirstValue
- GetKeys
- GetLastKey
- GetLastValue
- getn
- GetWinningKey
- HasValue
- Inherit
- insert
- IsEmpty
- IsSequential
- KeyFromValue
- KeysFromValue
- LowerKeyNames
- maxn
- MemberValuesFromKey
- Merge
- move
- Pack
- Random
- remove
- RemoveByValue
- Reverse
- Sanitise
- Shuffle
- sort
- SortByKey
- SortByMember
- SortDesc
- ToString
team
- AddScore
- BestAutoJoinTeam
- GetAllTeams
- GetClass
- GetColor
- GetName
- GetPlayers
- GetScore
- GetSpawnPoint
- GetSpawnPoints
- Joinable
- NumPlayers
- SetClass
- SetColor
- SetScore
- SetSpawnPoint
- SetUp
- TotalDeaths
- TotalFrags
- Valid
timer
- Adjust
- Check
- Create
- Destroy
- Exists
- Pause
- Remove
- RepsLeft
- Simple
- Start
- Stop
- TimeLeft
- Toggle
- UnPause
umsg
- Angle
- Bool
- Char
- End
- Entity
- Float
- Long
- PoolString
- Short
- Start
- String
- Vector
- VectorNormal
undo
- AddEntity
- AddFunction
- Create
- Do_Undo
- Finish
- GetTable
- MakeUIDirty
- ReplaceEntity
- SetCustomUndoText
- SetPlayer
- SetupUI
usermessage
utf8
- charpattern
- char
- codepoint
- codes
- force
- GetChar
- len
- offset
- sub
util
vgui
video
- Record
weapons
- Get
- GetList
- GetStored
- IsBasedOn
- OnLoaded
- Register
widgets
- PlayerTick
- RenderMe

Hooks 11

Game Events 40

Panels 129

ContentHeader
- OpenMenu
- ToTable
ContentIcon
ContentSidebar
ContextBase
ControlPanel
ControlPresets
- AddConVar
- AddOption
- Clear
- GetConVars
- OnSelect
- OpenPresetEditor
- QuickSaveInternal
- QuickSavePreset
- ReloadPresets
- SetLabel
- SetOptions
- SetPreset
- Update
DAdjustableModelPanel
DAlphaBar
DBinder
DBubbleContainer
DButton
DCategoryList
- Add
- AddItem
- UnselectAll
DCheckBox
- OnChange
- DoClick
- GetChecked
- IsEditing
- SetChecked
- SetValue
- Toggle
DCheckBoxLabel
- OnChange
- GetChecked
- GetIndent
- SetBright
- SetChecked
- SetConVar
- SetDark
- SetFont
- SetIndent
- SetTextColor
- SetValue
- SizeToContents
- Toggle
DCollapsibleCategory
DColorButton
- GetColor
- GetDrawBorder
- GetID
- GetSelected
- IsDown
- SetColor
- SetDrawBorder
- SetID
DColorCombo
DColorCube
DColorMixer
- ValueChanged
- ConVarThink
- DoConVarThink
- GetAlphaBar
- GetColor
- GetConVarA
- GetConVarB
- GetConVarG
- GetConVarR
- GetPalette
- GetVector
- GetWangs
- SetAlphaBar
- SetBaseColor
- SetColor
- SetConVarA
- SetConVarB
- SetConVarG
- SetConVarR
- SetLabel
- SetPalette
- SetVector
- SetWangs
- UpdateColor
- UpdateConVar
- UpdateConVars
- UpdateDefaultColor
DColorPalette
DColumnSheet
DComboBox
DDragBase
DDrawer
- Close
- GetOpenSize
- GetOpenTime
- Open
- SetOpenSize
- SetOpenTime
- Toggle
DEntityProperties
DExpandButton
- GetExpanded
- SetExpanded
DFileBrowser
- OnDoubleClick
- OnRightClick
- OnSelect
- Clear
- GetBaseFolder
- GetCurrentFolder
- GetFileTypes
- GetFolderNode
- GetModels
- GetName
- GetOpen
- GetPath
- GetSearch
- SetBaseFolder
- SetCurrentFolder
- SetFileTypes
- SetModels
- SetName
- SetOpen
- SetPath
- SetSearch
- Setup
- SetupFiles
- SetupTree
- ShowFolder
- SortFiles
DForm
- AddItem
- Button
- CheckBox
- ComboBox
- ControlHelp
- GetAutoSize
- GetSpacing
- Help
- ListBox
- NumberWang
- NumSlider
- PanelSelect
- PropSelect
- Rebuild
- SetAutoSize
- SetName
- SetSpacing
- TextEntry
DFrame
DGrid
- AddItem
- GetCols
- GetColWide
- GetItems
- GetRowHeight
- RemoveItem
- SetCols
- SetColWide
- SetRowHeight
- SortByMember
DHorizontalDivider
- GetDividerWidth
- GetDragging
- GetHoldPos
- GetLeft
- GetLeftMin
- GetLeftWidth
- GetMiddle
- GetRight
- GetRightMin
- SetDividerWidth
- SetDragging
- SetHoldPos
- SetLeft
- SetLeftMin
- SetLeftWidth
- SetMiddle
- SetRight
- SetRightMin
- StartGrab
DHorizontalScroller
DHScrollBar
- AddScroll
- AnimateTo
- BarScale
- GetHideButtons
- GetOffset
- GetScroll
- Grip
- SetHideButtons
- SetScroll
- SetUp
DHTML
DHTMLControls
DIconBrowser
DIconLayout
DImage
DImageButton
DKillIcon
- GetName
- SetName
DLabel
DLabelEditable
DLabelURL
DListBox
DListBoxItem
DListView
DListView_Column
DListView_Line
- OnRightClick
- OnSelect
- DataLayout
- GetAltLine
- GetColumnText
- GetID
- GetListView
- GetSortValue
- GetValue
- IsLineSelected
- SetAltLine
- SetColumnText
- SetID
- SetListView
- SetSelected
- SetSortValue
- SetValue
DMenu
DMenuBar
DMenuOption
- AddSubMenu
- GetChecked
- GetIsCheckable
- GetMenu
- GetRadio
- OnChecked
- SetChecked
- SetIsCheckable
- SetMenu
- SetRadio
- SetSubMenu
- ToggleCheck
DMenuOptionCVar
DModelPanel
- LayoutEntity
- PostDrawModel
- PreDrawModel
- DrawModel
- GetAmbientLight
- GetAnimated
- GetAnimSpeed
- GetCamPos
- GetColor
- GetEntity
- GetFOV
- GetLookAng
- GetLookAt
- GetModel
- RunAnimation
- SetAmbientLight
- SetAnimated
- SetAnimSpeed
- SetCamPos
- SetColor
- SetDirectionalLight
- SetEntity
- SetFOV
- SetLookAng
- SetLookAt
- SetModel
- StartScene
DModelSelect
- SetHeight
- SetModelList
DModelSelectMulti
- AddModelList
DNotify
- AddItem
- GetAlignment
- GetItems
- GetLife
- GetSpacing
- SetAlignment
- SetLife
- SetSpacing
- Shuffle
DNumberScratch
- OnValueChanged
- DrawNotches
- DrawScreen
- GetActive
- GetDecimals
- GetFloatValue
- GetFraction
- GetMax
- GetMin
- GetRange
- GetShouldDrawScreen
- GetTextValue
- GetZoom
- IdealZoom
- IsEditing
- LockCursor
- PaintScratchWindow
- SetActive
- SetDecimals
- SetFloatValue
- SetFraction
- SetMax
- SetMin
- SetShouldDrawScreen
- SetValue
- SetZoom
- UpdateConVar
DNumberWang
- OnValueChanged
- GetDecimals
- GetFloatValue
- GetFraction
- GetInterval
- GetMax
- GetMin
- GetTextArea
- GetValue
- HideWang
- SetDecimals
- SetFloatValue
- SetFraction
- SetInterval
- SetMax
- SetMin
- SetMinMax
- SetValue
DNumSlider
- OnValueChanged
- GetDecimals
- GetDefaultValue
- GetMax
- GetMin
- GetRange
- GetTextArea
- GetValue
- IsEditing
- ResetToDefaultValue
- SetConVar
- SetDark
- SetDecimals
- SetDefaultValue
- SetMax
- SetMin
- SetMinMax
- SetValue
- TranslateSliderValues
- UpdateNotches
- ValueChanged
DPanel
DPanelList
DPanelOverlay
DPanelSelect
DPanPanel
DProgress
- GetFraction
- SetFraction
DProperties
DProperty_Combo
DProperty_Float
- GetDecimals
DProperty_Generic
- GetRow
- SetRow
- Setup
- ValueChanged
DProperty_VectorColor
- Setup
- SetValue
DPropertySheet
DRGBPicker
- OnChange
- GetPosColor
- GetRGB
- SetRGB
DScrollPanel
DShape
DSizeToContents
- GetSizeX
- GetSizeY
- SetSizeX
- SetSizeY
DSlider
DSprite
- GetColor
- GetHandle
- GetMaterial
- GetRotation
- SetColor
- SetHandle
- SetMaterial
- SetRotation
DTab
DTextEntry
DTileLayout
- OnModified
- ClearTiles
- ConsumeTiles
- Copy
- CopyContents
- FindFreeTile
- FitsInTile
- GetBaseSize
- GetBorder
- GetMinHeight
- GetSpaceX
- GetSpaceY
- GetTile
- Layout
- LayoutTiles
- SetBaseSize
- SetBorder
- SetMinHeight
- SetSpaceX
- SetSpaceY
- SetTile
DTooltip
DTree
DTree_Node
DVerticalDivider
- DoConstraints
- GetBottom
- GetBottomMin
- GetDividerHeight
- GetDragging
- GetHoldPos
- GetMiddle
- GetTop
- GetTopHeight
- GetTopMax
- GetTopMin
- SetBottom
- SetBottomMin
- SetDividerHeight
- SetDragging
- SetHoldPos
- SetMiddle
- SetTop
- SetTopHeight
- SetTopMax
- SetTopMin
- StartGrab
DVScrollBar
- AddScroll
- AnimateTo
- BarScale
- GetHideButtons
- GetOffset
- GetScroll
- Grip
- SetHideButtons
- SetScroll
- SetUp
IconEditor
ImageCheckBox
- GetChecked
- Set
- SetChecked
- SetMaterial
Material
- SetAlpha
- SetMaterial
MatSelect
PropSelect
SpawnIcon
SpawnmenuContentPanel
TextEntry
- OnKeyCodeTyped
- OnTextChanged
UGCPublishWindow
AchievementIcon
AvatarImage
Awesomium
Button
CheckButton
ContentSidebarToolbox
CtrlListBox
DCategoryHeader
DListLayout
DListView_ColumnPlain
DListView_DraggerBar
DListViewHeaderLabel
DListViewLabel
DListViewLine
DNumPad
DProperty_Boolean
DProperty_Entity
DProperty_Int
DScrollBarGrip
DTree_Node_Button
EditablePanel
fingerposer
FingerVar
Frame
HTML
Label
ModelImage
PanelList
PresetEditor
RadioButton
RichText
SlideBar
Slider
TGAImage
URLLabel

Enumerations 99

Structures 69

Shaders 15

Miscellaneous Reference 30

	
		OSZAR »