diff --git a/modules/juce_audio_basics/midi/juce_MidiFile.h b/modules/juce_audio_basics/midi/juce_MidiFile.h index d9f7a0b746..0f507b3fc4 100644 --- a/modules/juce_audio_basics/midi/juce_MidiFile.h +++ b/modules/juce_audio_basics/midi/juce_MidiFile.h @@ -62,7 +62,7 @@ public: /** Returns a pointer to one of the tracks in the file. - @returns a pointer to the track, or 0 if the index is out-of-range + @returns a pointer to the track, or nullptr if the index is out-of-range @see getNumTracks, addTrack */ const MidiMessageSequence* getTrack (int index) const noexcept; diff --git a/modules/juce_audio_basics/synthesisers/juce_Synthesiser.h b/modules/juce_audio_basics/synthesisers/juce_Synthesiser.h index f971189a82..a6681d0554 100644 --- a/modules/juce_audio_basics/synthesisers/juce_Synthesiser.h +++ b/modules/juce_audio_basics/synthesisers/juce_Synthesiser.h @@ -107,7 +107,7 @@ public: /** Returns the sound that this voice is currently playing. - Returns 0 if it's not playing. + Returns nullptr if it's not playing. */ SynthesiserSound::Ptr getCurrentlyPlayingSound() const { return currentlyPlayingSound; } @@ -454,7 +454,7 @@ protected: /** Searches through the voices to find one that's not currently playing, and which can play the given sound. - Returns 0 if all voices are busy and stealing isn't enabled. + Returns nullptr if all voices are busy and stealing isn't enabled. This can be overridden to implement custom voice-stealing algorithms. */ diff --git a/modules/juce_audio_devices/audio_io/juce_AudioDeviceManager.h b/modules/juce_audio_devices/audio_io/juce_AudioDeviceManager.h index 5e76a80a9d..ac9c8f9c1e 100644 --- a/modules/juce_audio_devices/audio_io/juce_AudioDeviceManager.h +++ b/modules/juce_audio_devices/audio_io/juce_AudioDeviceManager.h @@ -170,7 +170,7 @@ public: by your app. @param numOutputChannelsNeeded a minimum number of output channels to open @param savedState either a previously-saved state that was produced - by createStateXml(), or 0 if you want the manager + by createStateXml(), or nullptr if you want the manager to choose the best device to open. @param selectDefaultDeviceOnFailure if true, then if the device specified in the XML fails to open, then a default device will be used diff --git a/modules/juce_audio_devices/midi_io/juce_MidiInput.h b/modules/juce_audio_devices/midi_io/juce_MidiInput.h index 132db4ee40..0397c0873a 100644 --- a/modules/juce_audio_devices/midi_io/juce_MidiInput.h +++ b/modules/juce_audio_devices/midi_io/juce_MidiInput.h @@ -129,7 +129,7 @@ public: This will attempt to create a new midi input device with the specified name, for other apps to connect to. - Returns 0 if a device can't be created. + Returns nullptr if a device can't be created. @param deviceName the name to use for the new device @param callback the object that will receive the midi messages from this device. diff --git a/modules/juce_audio_devices/midi_io/juce_MidiOutput.h b/modules/juce_audio_devices/midi_io/juce_MidiOutput.h index f27402a422..81ccd63b62 100644 --- a/modules/juce_audio_devices/midi_io/juce_MidiOutput.h +++ b/modules/juce_audio_devices/midi_io/juce_MidiOutput.h @@ -74,7 +74,7 @@ public: This will attempt to create a new midi output device that other apps can connect to and use as their midi input. - Returns 0 if a device can't be created. + Returns nullptr if a device can't be created. @param deviceName the name to use for the new device */ diff --git a/modules/juce_audio_processors/format/juce_AudioPluginFormatManager.h b/modules/juce_audio_processors/format/juce_AudioPluginFormatManager.h index f71278f211..6743192396 100644 --- a/modules/juce_audio_processors/format/juce_AudioPluginFormatManager.h +++ b/modules/juce_audio_processors/format/juce_AudioPluginFormatManager.h @@ -76,7 +76,7 @@ public: The caller is responsible for deleting the object that is returned. - If it can't load the plugin, it returns 0 and leaves a message in the + If it can't load the plugin, it returns nullptr and leaves a message in the errorMessage string. */ AudioPluginInstance* createPluginInstance (const PluginDescription& description, diff --git a/modules/juce_core/files/juce_File.h b/modules/juce_core/files/juce_File.h index 94e2a3d9fb..879d1c22ab 100644 --- a/modules/juce_core/files/juce_File.h +++ b/modules/juce_core/files/juce_File.h @@ -571,7 +571,7 @@ public: /** Creates a stream to read from this file. @returns a stream that will read from this file (initially positioned at the - start of the file), or 0 if the file can't be opened for some reason + start of the file), or nullptr if the file can't be opened for some reason @see createOutputStream, loadFileAsData */ FileInputStream* createInputStream() const; @@ -583,7 +583,7 @@ public: to write to an empty file. @returns a stream that will write to this file (initially positioned at the - end of the file), or 0 if the file can't be opened for some reason + end of the file), or nullptr if the file can't be opened for some reason @see createInputStream, appendData, appendText */ FileOutputStream* createOutputStream (int bufferSize = 0x8000) const; diff --git a/modules/juce_core/streams/juce_InputSource.h b/modules/juce_core/streams/juce_InputSource.h index 8e2b5354ed..ea852842ff 100644 --- a/modules/juce_core/streams/juce_InputSource.h +++ b/modules/juce_core/streams/juce_InputSource.h @@ -49,7 +49,7 @@ public: //============================================================================== /** Returns a new InputStream to read this item. - @returns an inputstream that the caller will delete, or 0 if + @returns an inputstream that the caller will delete, or nullptr if the filename isn't found. */ virtual InputStream* createInputStream() = 0; @@ -57,7 +57,7 @@ public: /** Returns a new InputStream to read an item, relative. @param relatedItemPath the relative pathname of the resource that is required - @returns an inputstream that the caller will delete, or 0 if + @returns an inputstream that the caller will delete, or nullptr if the item isn't found. */ virtual InputStream* createInputStreamFor (const String& relatedItemPath) = 0; diff --git a/modules/juce_core/xml/juce_XmlDocument.h b/modules/juce_core/xml/juce_XmlDocument.h index 1b43a07a52..44a6245e0e 100644 --- a/modules/juce_core/xml/juce_XmlDocument.h +++ b/modules/juce_core/xml/juce_XmlDocument.h @@ -90,7 +90,7 @@ public: /** Creates an XmlElement object to represent the main document node. This method will do the actual parsing of the text, and if there's a - parse error, it may returns 0 (and you can find out the error using + parse error, it may returns nullptr (and you can find out the error using the getLastParseError() method). See also the parse() methods, which provide a shorthand way to quickly diff --git a/modules/juce_core/xml/juce_XmlElement.h b/modules/juce_core/xml/juce_XmlElement.h index e8b430620b..cb496b9b11 100644 --- a/modules/juce_core/xml/juce_XmlElement.h +++ b/modules/juce_core/xml/juce_XmlElement.h @@ -480,7 +480,7 @@ public: It's not very efficient to iterate the sub-elements by index - see getNextElement() for an example of how best to iterate. - @returns the n'th child of this element, or 0 if the index is out-of-range + @returns the n'th child of this element, or nullptr if the index is out-of-range @see getNextElement, isTextElement, getChildByName */ XmlElement* getChildElement (int index) const noexcept; @@ -488,7 +488,7 @@ public: /** Returns the first sub-element with a given tag-name. @param tagNameToLookFor the tag name of the element you want to find - @returns the first element with this tag name, or 0 if none is found + @returns the first element with this tag name, or nullptr if none is found @see getNextElement, isTextElement, getChildElement */ XmlElement* getChildByName (const String& tagNameToLookFor) const noexcept; diff --git a/modules/juce_gui_basics/commands/juce_ApplicationCommandManager.h b/modules/juce_gui_basics/commands/juce_ApplicationCommandManager.h index 93e0430b7a..c3e2951ebb 100644 --- a/modules/juce_gui_basics/commands/juce_ApplicationCommandManager.h +++ b/modules/juce_gui_basics/commands/juce_ApplicationCommandManager.h @@ -77,8 +77,8 @@ class Desktop; component hierarchy for those that also implement the ApplicationCommandTarget interface. If an ApplicationCommandTarget isn't interested in the command that is being invoked, then the next one in line will be tried (see the ApplicationCommandTarget::getNextCommandTarget() - method), and so on until ApplicationCommandTarget::getNextCommandTarget() returns 0. At this - point if the command still hasn't been performed, it will be passed to the current + method), and so on until ApplicationCommandTarget::getNextCommandTarget() returns nullptr. + At this point if the command still hasn't been performed, it will be passed to the current JUCEApplication object (which is itself an ApplicationCommandTarget). To exert some custom control over which ApplicationCommandTarget is chosen to invoke a command, @@ -298,7 +298,7 @@ public: /** Examines this component and all its parents in turn, looking for the first one which is a ApplicationCommandTarget. - Returns the first ApplicationCommandTarget that it finds, or 0 if none of them implement + Returns the first ApplicationCommandTarget that it finds, or nullptr if none of them implement that class. */ static ApplicationCommandTarget* findTargetForComponent (Component* component); diff --git a/modules/juce_gui_basics/components/juce_Component.h b/modules/juce_gui_basics/components/juce_Component.h index 7430836ef1..ee716cb5a1 100644 --- a/modules/juce_gui_basics/components/juce_Component.h +++ b/modules/juce_gui_basics/components/juce_Component.h @@ -2053,8 +2053,8 @@ public: //============================================================================== /** Components can implement this method to provide a MarkerList. - The default implementation of this method returns 0, but you can override it to - return a pointer to the component's marker list. If xAxis is true, it should + The default implementation of this method returns nullptr, but you can override + it to return a pointer to the component's marker list. If xAxis is true, it should return the X marker list; if false, it should return the Y markers. */ virtual MarkerList* getMarkers (bool xAxis); diff --git a/modules/juce_gui_basics/components/juce_Desktop.h b/modules/juce_gui_basics/components/juce_Desktop.h index a587773c59..266ccc4ea2 100644 --- a/modules/juce_gui_basics/components/juce_Desktop.h +++ b/modules/juce_gui_basics/components/juce_Desktop.h @@ -175,7 +175,7 @@ public: /** Returns the component that is currently being used in kiosk-mode. This is the component that was last set by setKioskModeComponent(). If none - has been set, this returns 0. + has been set, this returns nullptr. */ Component* getKioskModeComponent() const noexcept { return kioskModeComponent; } @@ -201,7 +201,7 @@ public: This will drill down into top-level windows to find the child component at the given position. - Returns 0 if the co-ordinates are inside a non-Juce window. + Returns nullptr if the co-ordinates are inside a non-Juce window. */ Component* findComponentAt (const Point& screenPosition) const; diff --git a/modules/juce_gui_basics/layout/juce_ComponentBuilder.h b/modules/juce_gui_basics/layout/juce_ComponentBuilder.h index 7e63fd87bc..79b78c171e 100644 --- a/modules/juce_gui_basics/layout/juce_ComponentBuilder.h +++ b/modules/juce_gui_basics/layout/juce_ComponentBuilder.h @@ -69,7 +69,7 @@ public: The first time that this method is called, the builder will attempt to create a component from the ValueTree, so you must have registered some suitable type handlers before calling - this. If there's a problem and the component can't be created, this method returns 0. + this. If there's a problem and the component can't be created, this method returns nullptr. The component that is returned is owned by this ComponentBuilder, so you can put it inside your own parent components, but don't delete it! The ComponentBuilder will delete it automatically @@ -213,7 +213,7 @@ public: */ void setImageProvider (ImageProvider* newImageProvider) noexcept; - /** Returns the current image provider that this builder is using, or 0 if none has been set. */ + /** Returns the current image provider that this builder is using, or nullptr if none has been set. */ ImageProvider* getImageProvider() const noexcept; //============================================================================= diff --git a/modules/juce_gui_basics/positioning/juce_MarkerList.h b/modules/juce_gui_basics/positioning/juce_MarkerList.h index 7cab04f462..352f214c19 100644 --- a/modules/juce_gui_basics/positioning/juce_MarkerList.h +++ b/modules/juce_gui_basics/positioning/juce_MarkerList.h @@ -89,7 +89,7 @@ public: /** Returns one of the markers in the list, by its index. */ const Marker* getMarker (int index) const noexcept; - /** Returns a named marker, or 0 if no such name is found. + /** Returns a named marker, or nullptr if no such name is found. Note that name comparisons are case-sensitive. */ const Marker* getMarker (const String& name) const noexcept; diff --git a/modules/juce_gui_basics/widgets/juce_Label.h b/modules/juce_gui_basics/widgets/juce_Label.h index 7499d45d85..cf968a4f16 100644 --- a/modules/juce_gui_basics/widgets/juce_Label.h +++ b/modules/juce_gui_basics/widgets/juce_Label.h @@ -148,7 +148,7 @@ public: /** If this label has been attached to another component using attachToComponent, this returns the other component. - Returns 0 if the label is not attached. + Returns nullptr if the label is not attached. */ Component* getAttachedComponent() const; diff --git a/modules/juce_gui_basics/widgets/juce_ToolbarItemComponent.h b/modules/juce_gui_basics/widgets/juce_ToolbarItemComponent.h index b4ccf30780..b675cbd731 100644 --- a/modules/juce_gui_basics/widgets/juce_ToolbarItemComponent.h +++ b/modules/juce_gui_basics/widgets/juce_ToolbarItemComponent.h @@ -76,7 +76,7 @@ public: */ int getItemId() const noexcept { return itemId; } - /** Returns the toolbar that contains this component, or 0 if it's not currently + /** Returns the toolbar that contains this component, or nullptr if it's not currently inside one. */ Toolbar* getToolbar() const; diff --git a/modules/juce_gui_basics/widgets/juce_TreeView.h b/modules/juce_gui_basics/widgets/juce_TreeView.h index 2a21d78c88..e0d7890b65 100644 --- a/modules/juce_gui_basics/widgets/juce_TreeView.h +++ b/modules/juce_gui_basics/widgets/juce_TreeView.h @@ -259,7 +259,7 @@ public: /** Creates a component that will be used to represent this item. - You don't have to implement this method - if it returns 0 then no component + You don't have to implement this method - if it returns nullptr then no component will be used for the item, and you can just draw it using the paintItem() callback. But if you do return a component, it will be positioned in the treeview so that it can be used to represent this item. @@ -605,7 +605,7 @@ public: /** Returns the tree's root item. - This will be the last object passed to setRootItem(), or 0 if none has been set. + This will be the last object passed to setRootItem(), or nullptr if none has been set. */ TreeViewItem* getRootItem() const noexcept { return rootItem; } diff --git a/modules/juce_gui_basics/windows/juce_AlertWindow.h b/modules/juce_gui_basics/windows/juce_AlertWindow.h index e0a9c2079f..c2e872b1e3 100644 --- a/modules/juce_gui_basics/windows/juce_AlertWindow.h +++ b/modules/juce_gui_basics/windows/juce_AlertWindow.h @@ -175,7 +175,7 @@ public: @param nameOfList the name that was passed into the addComboBox() method when creating the drop-down - @returns the ComboBox component, or 0 if none was found for the given name. + @returns the ComboBox component, or nullptr if none was found for the given name. */ ComboBox* getComboBoxComponent (const String& nameOfList) const; diff --git a/modules/juce_gui_basics/windows/juce_ResizableWindow.h b/modules/juce_gui_basics/windows/juce_ResizableWindow.h index b547352af6..1024669aec 100644 --- a/modules/juce_gui_basics/windows/juce_ResizableWindow.h +++ b/modules/juce_gui_basics/windows/juce_ResizableWindow.h @@ -231,8 +231,8 @@ public: //============================================================================== /** Returns the current content component. - This will be the component set by setContentOwned() or setContentNonOwned, or 0 if none - has yet been specified. + This will be the component set by setContentOwned() or setContentNonOwned, or + nullptr if none has yet been specified. @see setContentOwned, setContentNonOwned */